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PREFACE 



The DECsystem-10 Operating System Commands manual is a complete 
reference document describing the commands available in the 
DECsystem-10 Operating System. Information presented here reflects 
the 6.03 release of the monitor and related programs. Commands to the 
monitor or command language interpreters are presented in alphabetical 
order for easy reference. 

DECsystem-10 Operating System Commands does not include reference 
material for assembly language programming. This information may be 
found in DECsystem-10 Monitor Calls (AA-0974C-TB) . The Monitor Calls 
manual is intended for experienced assembly language programmers. It 
includes discussions of monitor programmed operators and the I/O 
devices connected to the system. 

The Introduction to DECsystem-10 manual (DEC-10-MZDC-D) gives an 
overview of the DECsystem-10 and its operating system, TOPS-10. This 
manual is written for someone familiar with computers and computing 
concepts who wishes to understand the functions of DECsystem-10 
components. It is not intended to be a programmer's reference manual 
and should be read once before reading the preceding documents. 

SYNOPSIS OF DECSYSTEM-10 OPERATING SYSTEM COMMANDS 

Chcipter 1 presents all available commands and introduces the operating 
system components that interface with the user. Chapter 2 is a 
detailed description of commands the monitor command language 
interpreter processes. Chapter 3 describes the system error messages 
and error codes, with correction procedures. The appendices contain 
all supplementary reference material and tables. 

CONVENTIONS USED IN DECSYSTEM-10 OPERATING SYSTEM COMMANDS 

The following conventions are observed within this document: 

dev: Any logical or physical device name. A colon (:) must 
be included when a device is specified as a part of a 
file specification. 

list A single file specification or a string of file 
specifications, consisting of a file name with or 
without a file name extension; device name if the 
file is not on disk; project-programmer number if the 
file is not in your disk area; protection code. 

arg A letter, a word, or a word abbreviation specifying 
the desired function of the command. 

jobn Any job number assigned by the monitor. 
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file.ext Any legal file name and extension. 

core The decimal number of IK blocks containing 512-word 
pages of memory. 

addr An octal address. 

c(addr) Contents of an octal address. 

[proj,prog] Project-programmer numbers; the square brackets ([ ]) 
must be included in the command string. 

fs Any legal file structure name or abbreviation. 

$ The symbol indicating when you type an ESCape or 

ALTmode. 

A X A control character obtained when you press the CTRL 

key and type a character key. 

* The system program response to a command string. 

The monitor's response to a command string. 

^J The symbol used to indicate when you should press the 

RETURN key. You should type a carriage return after 
every command to the monitor command language 
interpreter. At times you can also terminate commands 
with an ESCape, ALTmode, CTRL/L, etc. 

Underscoring indicates user input, i.e., the words and 

numbers that you are to type. 

n A decimal number. 

= An equal sign, which is used in command strings to 

separate input and output file specifications. 
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CHAPTER 1 
INTRODUCTION 



The DECsystem-10 Operating System, called TOPS-10, is the interface 
between you and the actual machine. Some of its functions are listed 
below. 

1. Scheduling multiple and simultaneous uses of the system 

2. Protecting system users from one another 

3. Allowing access to system resources, including peripheral 
devices 

4. Providing a comprehensive disk file system 

5. Directing data flow between peripheral devices and your 
programs 

6. Controlling non-interactive jobs 

7. Overlapping input/output operations with computations, for 
high system efficiency 

You communicate with the operating system by means of the monitor 
command language. With the command language, you may access available 
resources of the computing system and obtain services provided by the 
operating system. 



1 . 1 JOBS 

The DECsystem-10 is a multiprogramming system; the system transfers 
control rapidly among a number of jobs, so that all jobs appear to be 
running simultaneously. The term job refers to the entire sequence of 
steps that you initiate from your terminal or card deck, or the 
operator initiates from a console. You initiate a job from your 
terminal by using the LOGIN command, and you end your job by using the 
KJOB command. If you initiate a job with a card deck, the job begins 
with the $JOB card and ends with the $EOJ (end-of-job) card. Operator 
jobs begin when the operator initializes the system, and they end when 
the system is taken down. 

You may initiate a job at the central computer site or from remote, 
telephone-connected, locations whether those jobs are batch, 
timesharing, or real-time. Once you initiate a job, it is possible 
for you to also initiate another job without killing the first. For 
example, you may initiate a timesharing job and, using the SUBMIT 
command, also submit a second job for batch processing. (Refer to 
Chapter 2.) You may then wait for the results from the batch job or 
have the results automatically output while you continue your 
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timesharing job. When configuring and loading the DECsystem-lQ , the 
system administrator sets a maximum number of jobs that the system can 
handle. This number may be set to 511 jobs if the system has 
sufficient memory, disk storage, processor capacity, and terminals. 



1.2 MONITOR MODE AND USER MODE 

Your terminal is either in monitor mode or user mode. In monitor 
mode, each line you type is sent to the monitor command language 
interpreter. When you execute certain commands, the system places the 
terminal in user mode. When the terminal is in user mode, it simply 
becomes an input/output (I/O) device for you. Your programs use the 
terminal for two purposes: 

1. To accept command strings from the terminal (user mode) 

2. To use the terminal as a direct I/O device (data mode) 
The following is an example of terminal dialogue: 



Monitor mode . R PIP ^7 

User mode * DSK : PROG . MAC=TTY \ *J 

Data mode THIS IS FILE 1"Z 



Monitor mode . R MACRO ^J 

User mode * ,TTY:=DSK:PROG^ 



Monitor command 

User command string 

User program using the 

terminal 

as an input device 

CTRL/C 

Monitor command 

User command string 



Data mode 



assembly listing 
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When the operator starts the system, each terminal is placed in 
monitor mode, ready for users to LOGIN to them (unless it is slaved or 
ASSIGNed by another job). However, if the system becomes fully loaded 
(i.e., the maximum number of jobs that the system is set to handle has 
been reached) and you try to LOGIN, you will receive the following 
error message: 



JOB CAPACITY EXCEEDED 

When you receive this message, wait a few minutes before 
LOGIN again. 



trying to 



If you are using the system in a batch card environment, you may think 
of your cards as being in input spooler mode, monitor mode, or user 
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mode. When your card is in input spooler mode, the card deck contains 
a control command beginning with a dollar sign ($) and is sent to the 
Spooler, SPRINT-10. (Refer to the GALAXY-10 Reference Manual .) 
SPRINT-10 interprets these commands and performs various actions to 
create a control file for the Batch Controller. When your card is in 
monitor mode, it contains a monitor command preceded by a period and 
is copied by SPRINT-10 into the control file. When the card is in 
user mode, it contains a user-level program command preceded by an 
asterisk (*) or an equal sign (=) and is also copied by SPRINT-10 into 
the control file. As each line in the control file is executed, the 
Batch Controller passes the monitor-level line to the monitor command 
language interpreter, and the user-level line to the user program. 
Figure 1-1 illustrates a sample card deck. 



INPUT SPOOLER MODE 

USER MODE 

MONITOR MODE 

MONITOR MODE 

INPUT SPOOLER MODE 

DATA MODE 

INPUT SPOOLER MODE 




SPRINT-10 COMMAND TO SIGNAL 
END OF CARD DECK 

USER COMMAND STRING 

MONITOR COMMAND 

MONITOR COMMAND 

SPRINT-10 CONTROL COMMAND 

SPRINT-10 CONTROL COMMAND 



Figure 1-1 Sample Card Deck 



1.3 COMMAND INTERPRETERS 

1.3.1 Monitor Command Language Interpreter 

When your terminal is in monitor mode, you communicate with the 
monitor command language interpreter. By means of commands to this 
interpreter, you may initialize jobs, allocate facilities, prepare 
source files, manipulate files, prepare, control, and examine object 
programs, control job sequences and multiple jobs, terminate jobs, 
send messages, and obtain job and system information. The interpreter 
processes the commands described in Chapter 2. 

The system, i.e., interpreter, processes most commands without delay. 
However, the system may momentarily delay a command if your job is 
swapped out to the disk and the command requires that your job be 
resident in core memory; the system executes the command when your 
job is swapped into core. The system signals the completion of each 
command when it outputs a carriage return/line feed sequence. If the 
system leaves your terminal in monitor mode, the system prints a 
period following the carriage return/line feed sequence. If the 
system leaves your terminal in user mode, the characters that are 
typed at the terminal come from your program and not from the 
operating system. Most standard system programs print an asterisk (*) 
on your terminal, indicating their readiness to accept your command 
strings. 

You may use the type-ahead technique if you are an experienced 
timesharing terminal user. With the type-ahead technique, you do not 
hcive to wait for the completion of one command before you begin 
another. If you desire two operations from the monitor, you can begin 
typing the request for the second operation before you receive the 
period that the system types after completing the first operation. 



1-3 



INTRODUCTION 

The command interpreter makes several checks before processing your 
commands. If you have not logged into the system and you have typed a 
command that requires that you be logged in, the system responds with 
the following error message: 

7L0GIN PLEASE 

and the system does not execute the command that you typed. The 
commands described in Chapter 2 require that you be logged into the 
system unless it is explicitly stated otherwise. 

When the system recognizes that you typed a command that requires that 
your job have core, and your job has no allocated core, the system 
prints the following error message: 

?N0 CORE ASSIGNED 

and the system does not execute the command that you typed. 

The monitor command language interpreter recognizes several special 
characters that cause specific functions to be performed. A CTRL/C 
interrupts your current running program and returns your terminal to 
monitor mode. This character causes the input line, back to the last 
break character (e.g., carriage return/line feed), to be deleted. 
This action is the equivalent of a CTRL/U. You must type two CTRL/Cs 
if your program is not requesting input from your terminal (i.e., if 
your program is in the middle of execution) . 

When you type the DELETE key, the system generates a character that 
causes the last character you typed to be deleted. This function 
permits you to correct typing errors. When you press the DELETE key n 
times, the system deletes the last n characters that you typed. The 
system echoes all deleted characters on your terminal and encloses the 
deleted characters in backslashes (\) . The system cannot delete any 
characters that you typed before the last break character or any 
characters already processed by your program. 

When you type a CTRL/U, the system deletes your current input line, 
back to the last break character. The system responds with a carriage 
return/line feed, after which you may retype the line. Once you have 
typed a break character, you can no longer use the line-editing 
features (e.g., CTRL/U and DELETE) on that line, except when you are 
using an editor. 

When you type a CTRL/0, the system temporarily suppresses output to 
your terminal. You would find this function useful when a program 
begins to output a long message that you are not interested in 
reading. If you do not want to wait for the system to finish printing 
the message, you can stop the system from outputting the message in 
one of two ways. The first way is for you to type two CTRL/Cs, but 
this action also stops the execution of your program. The second way, 
is for you to type a CTRL/O. When you type a CTRL/O, the system 
continues executing your program, but it does not print any output on 
your terminal. The system responds with a carriage return/line feed 
sequence. The system reinstates output to the terminal when one of 
the following conditions occurs: 

1. Your executing program requests input from your terminal. 

2. Your program terminates and returns control to the monitor. 

3. You type a CTRL/C, which returns control to the monitor. 

4. You type another CTRL/O. 
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When you type a CTRL/T, the system prints status information 

pertaining to your job on your terminal. The information that the 

system prints is the same as it prints when you issue the USESTAT 
command. This information is listed below. 

1. The incremental day time, which is the time since you last 
issued a CTRL/T or a USESTAT command or the time since you 
logged in if you have not issued a CTRL/T or USESTAT command 

2. The incremental run time, which is the CPU time used since 
you last issued a CTRL/T, USESTAT command, LOGIN command, or 
TIME command 

3. The increment disk reads, which is the disk blocks read since 
you last issued a CTRL/T, USESTAT command, LOGIN command, or 
DSK command 

4. The program name 

5. The core size 

6. The job state 

7. The program counter, which is the address of the current 
instruction 

8. The I/O state of the file, which can be INPUT WAIT or OUTPUT 
WAIT 

9. The name of the file 

10. The block number of the file if the system is performing user 
I/O, or the words (MONITOR I/O) if the system is performing 
monitor I/O 

11. The number of pages in the current working set, if running 
under virtual memory 

12. The number of pages not in the working set 

13. The amount of virtual core currently in use 

14. The page rate 

By typing a CTRL/T, you can determine your job's progress without 
interrupting its execution. Note that when you type a CTRL/T the 
CTRL/T character is not passed to the job as an input character. 
However, some programs activate a special interrupt feature when you 
type a CTRL/T. (Refer to DECsystem-10 Monitor Calls .) When you type 
a CTRL/T, control of such programs automatically transfers to a 
routine used to output status information, in addition to the regular 
USESTAT printout. 

For example, when you type a CTRL/T while using an editor, which is in 
the midst of a search, information concerning the progress of the 
search may be printed. Note that CTRL/T output is typed even if you 
have suppressed output by use of CTRL/O. 
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When you type a CTRL/R (~R) , the system types the current input line, 
after it has processed all DELETES. If you type a line incorrectly, 
then make corrections using the DELETE key, the system will print the 
corrected line when you type a CTRL/R. An example of this function is 
shown below. 

SET TTQ\Q\Y N0\0\O FILE\E\L ~R 
SET TTY NO FILL 

When you type a CTRL/R, the system issues a carriage return/line feed 
sequence before printing the corrected input line and leaves the input 
position indicator at its previous location. 



1.3.2 Batch Command Interpreter 

All monitor commands that you use via the batch system use the monitor 
command language interpreter. In addition to monitor commands, batch 
users can issue commands that are used only by the batch programs: 
the Input Spooler (SPRINT-10) , and the Batch Controller (BATCON) . The 
Input Spooler processes the control commands. (Refer to the GALAXY-10 
Reference Manual . ) 

By means of these commands, you can create a control file, a log file, 
and data files; you can enter jobs into the batch input queue; you 
can insert monitor commands into the control file. The Batch 
Controller performs an additional interpretation. When the system 
executes your job, the Batch Controller processes the control file to 
pass monitor commands to the monitor command language interpreter and 
it passes user-level commands to the appropriate programs. 



1.4 COMMAND FORMATS 

You type each command as a line of ASCII characters in uppercase or 
lowercase, or a mixture of uppercase and lowercase characters. If you 
type spaces or TABs before a command name, the system ignores them. 
You can type comments on the same line as a command by preceding the 
comment with a semicolon. The monitor and batch command language 
interpreters do not interpret or execute a line of comments. You 
should terminate every command to the monitor command language 
interpreter by pressing the RETURN key. In this manual, the -*J 
symbol indicates when you should press the RETURN key. If you should 
type an unrecognizable command, the system types the entire line 
again, preceding and following the line with a question mark. The 
system leaves the terminal in monitor mode. 

You can continue command lines to several system programs (e.g., 
DIRECT, DUMP, QUEUE, and LINK-10) by placing a hyphen (-) as the last 
nonblank, noncomment character before the carriage return/line feed 
sequence (i.e., before pressing the RETURN key). The system treats 
continuation lines as part of the current command line, which it does 
not consider as being terminated until it sees a carriage return/line 
feed sequence that is not preceded by a hyphen. This feature allows 
you to type indefinitely long command lines. 
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1.4.1 Command Names 

The commands you type to the monitor command language interpreter are 
one to six characters long. If you type any character past the sixth 
character, the system ignores it. You need only type enough 
characters to uniquely identify the command. However, when you are 
entering a batch job, you should use the command's full name, because 
the number of unique characters may change when new commands are added 
to the operating system. If this were the case, your card decks or 
control files containing abbreviated command names may no longer 
function properly if new commands were added to the monitor. 

Installations that implement additional commands should preserve the 
uniqueness of the first three letters of all existing commands. 

When you issue control commands to the Stacker in the multiprogramming 
batch system, you must issue a dollar sign ($) in the first column of 
the card or line and an alphabetic character in the second column. 
You can abbreviate the command name, as long as the specified command 
name is unique. The first three characters of the command generally 
denote uniqueness. 



1.4.2 Command Arguments 

Specify arguments to a command after the command name and separate 
them from the command name by a space or a TAB. If the monitor 
command interpreter recognizes a command name, but cannot find a 
necessary argument, the monitor responds with the following error 
message: 

?T00 FEW ARGUMENTS 

After the system prints the error message, your terminal is left in 
monitor mode. You can then retype the command. 



1,4.2.1 Project-Programmer Numbers and Passwords - Only authorized 
users have access to the DECsystem-10 . Your installation's system 
administrator provides each authorized user with a project number, a 
programmer number, and a password. The project numbers range from 1 
to 377777 (octal) . (Note that numbers 1 through 10 are reserved for 
Digital.) The programmer numbers range from 1 to 777777 (octal). 
(Note that numbers 1 through 7 are reserved for Digital and numbers 
400000 through 777777 are reserved for special purposes.) 

NOTE 

When the project number is in the 1 to 
10 range, all programmer numbers are 
reserved for Digital. When the 
programmer number is in the 1 to 7 
range, all project numbers are reserved 
for Digital. 

These numbers identify each user and his corresponding area on file 

structures. When you specify a project-programmer number in a command 

string, the project and programmer numbers are separated by a comma 
and are enclosed in square brackets (e.g., [27,4072]). 
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Your password is one to six characters long and is used only when you 
log in to the system. To maintain password secrecy, the monitor does 
not echo the password when you type it. When you are using a terminal 
with local copy, the monitor types a mask when you type your password, 
thereby making the password unreadable. (Refer to DECsystem-10 
Monitor Calls. ) 



1.4.2.2 Device Names - A physical device name is associated with each 
system device controlled by the system. A physical device name 
consists of three letters, zero or two digits specifying the node 
name, zero to three digits specifying the unit number, and a colon. 
Table 1-1 lists the generic physical devices names associated with the 
various system devices. (Refer to Appendix A for the list of special 
disk devices that are predefined in the DECsystem-10.) 



You can associate a logical device name w 
device. A logical device name can be 
followed by a colon. When you refer to th 
it by logical name or physical name. Log 
when writing programs, to use arbitrarily 
assign a physical device to the logi 
However, you should use care when assign 
because they have priority over physi 
assigned the logical name DSK to a DECtape 
to use the disk via the name DSK, you wo 
because of the logical name assignment. 



ith a particular physical 
one to six characters long, 
e device, you can refer to 
ical device names allow you, 
selected device names and to 
cal name at execution time, 
ing logical device names, 
cal device names. If you 
, every time you attempted 
uld use the DECtape instead, 



Except for disk devices, you can assign only one logical device name 
to a physical device at one time. You can use the name for another 
device by disassociating the name from the first device and then 
associating it with the second device, via the ASSIGN command. You 
disassociate logical names from physical devices by using the DEASSIGN 
command. (Refer to Chapter 2.) Each time you issue a subsequent 
ASSIGN command , the system replaces the old logical name with the 
newly specified logical name. 



Table 1-1 
System Devices 



Device 


Generic Physical 


Device Name 




3-letter 


2-letter 


Card punch 


CDP: 


CP: 


Card reader 


CDR: 


CR: 


Console TTY 


CTY: 





DECtape 


DTx: 


DT: 


Disk 


DSK: 


DS: 


Packs 


DPx: 


DP: 


Fixed head 


FHx: 


FH: 


Display 


DIS: 





Line printer 


LPT: 


LP: 


lowercase/uppercase 


— - 


LL: 


uppercase 





LU: 


Magnetic tape 


MTx: 





7-track 





M7: 


9-track 


___ 


M9: 
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Table 1-1 (Cont.) 
System Devices 



Device 


Generic Physical 


Device Name 




3-letter 


2-letter 


Operator terminal 


OPR 




___ 


Paper-tape punch 


PTP 




PP: 


Paper-tape reader 


PTR 




PR: 


Plotter 


PLT 







Pseudo-TTY 


PTY 







System library 


SYS 




SY: 


Terminal 


TTY: 




TT: 



The following examples illustrate the use of physical and logical 
device names: 



.ASSIGN DTA: ABC: 



DTA260 ASSIGNED 



.ASSIGN PTP: ABC: 



You request a DECtape drive with 
the logical name ABC. 

The monitor gives you device 
DTA260. You then mount a DECtape 
on drive DTA260. 

You request the paper-tape punch 
with the logical name ABC. 



%LOGICAL NAME WAS IN USE, PTP260 ASSIGNED 



.R PIP 

*ABC : =DTA260 : FILEA 



.ASSIGN DTA: DEF: 



ASSIGNED TO JOB Nl ,N2 , 



.ASSIGN DTA6: DEF: 



The monitor types an error message, 
telling you that the paper-tape 
punch is reserved. 

The logical name ABC now refers to 
the paper-tape punch. 

You request the system program PIP. 

You issue a command string to PIP 
asking that file FILEA be 
transferred from device DTA260 to 
physical device ABC (physical 
device PTP: ) . 

You type a CTRL/C, returning your 
terminal to monitor mode. 

You request another DECtape drive 
with the logical name DEF. 

The monitor issues a message 
telling you that all drives are in 
use by the specified jobs. The 
monitor does not assign a DECtape 
drive or a logical name. 

You request drive DTA6 (which you 
already have assigned to you) with 
the logical name DEF. The system 
clears the copy of the directory 
currently in core. 
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DTA261 ASSIGNED 



.DEASSIGN PTP: 

.R PIP 
*ABC:=DEF:FILEB 

7DEVICE ABC DOES NOT EXIST 



.ASSIGN DTA260: XYZ 



DTA261 ASSIGNED 



You mount a new DECtape on the 
previously assigned drive. The 
system reads in the new DECtape 
directory into core when you next 
access the DECtape. 

You deassign the paper tape punch, 
thereby clearing the logical name 
ABC. 

You request the PIP system program. 

You request that the file FILEB be 
transferred from device DEF to 
device ABC. 

The system prints an error message 
indicating that the logical device 
name ABC is no longer assigned. 

You type a CTRL/C, returning your 
terminal to monitor mode. 

You request drive DTA260 again with 
the logical name XYZ. The system 
disassociates the logical name DEF 
from DTA260 and clears the 
directory from core. 

You mount a new DECtape. The 
system reads the new directory into 
core when you next access the 
DECtape. 



1.4.2.3 File 
grouped accord 
arrangements of 
type. A file 
distributed ove 
a single name, 
unit. The oper 
the operator 
to five charact 
a unit name, 
names for publi 
decreasing spee 



Structure 

ing to f 
128-word 
structur 

r several 
However , 

ator assig 

defines th 

ers long, 
or an e 

c file str 

d. 



Names - In the 
ile structures, 
blocks on one or 
e can exist on o 
disk units of the 

two file structu 
ns a SIXBIT name 
e system's file s 
and cannot duplic 
xisting file stru 
uctures are DSKA, 



system, disk devices are 

File structures are logical 
more disk units of the same 
ne disk unit; or, it can be 

same type and designated by 
res cannot exist on the same 
to every file structure when 
tructures. This name is one 
ate a physical device name, 
cture name. The recommended 

DSKB, ..., DSKn in order of 



1.4.2.4 File Specifications - The system stores all information (both 
programs and data) as named files. Each named file has a file 
specification associated with it. The file specification consists of 
the following information: 

1. The physical device name or file structure name 

2. The file name 

3. The file name extension 
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4. The ordered list of directory names 

5. The access protection code 

The first four items of the file specification are necessary to 
identify a disk file uniquely. If you issue a file specification for 
devices other than DECtape or disk, the system ignores them. DECtapes 
and disks are the only directory-oriented devices. Note that item 4 
in the list above does not apply to DECtapes. 

The physical device name used for DECtape or the file structure name 
used for disk may be any legal device name described in the previous 
sections of this manual. You should always type a colon following the 
device name (e.g., DTA3 : ) . 

A file name is one to six characters long; the system ignores all 
characters past the sixth. The file name extension is a period (.) 
followed by zero to three characters. It is used to indicate the type 
of information in the file. (Refer to Appendix A for a list of 
standard file name extensions.) You should use only standard file 
name extensions, though other extensions may be valid. Note that most 
programs recognize only file names and extensions consisting of 
letters and digits. 

The ordered list of directory names identifies the disk area where the 
file is stored. This list may be a user file directory (UFD) 
represented by the owner's project-programmer number, or a user file 
directory followed by one or more sub-file directories (SFDs) . You 
must enclose a directory name in square brackets. The access 
protection code of a file is a 3-digit octal code designating the 
users who can read or write the file. The code must be enclosed in 
angle brackets (< >) , and you specify it only for output files. For a 
given file, users are divided into three groups: owner of the file, 
users with the same project number as the owner, all other users. The 
standard protection code is 057, allowing users in the owner's project 
to read and execute the file, and prevent access by all other users. 
(For a complete description of access protection, refer to 
DECsystem-10 Monitor Calls .) Note that the standard protection code 
can be redefined by your installation. 

Also, you can issue the SET DEFAULT PROTECTION command. The argument 
you specify in this command overrides the standard protection code 
when you create subsequent files. 

The following information is needed in command strings when referring 
to a file: 

1. The file name 

2. The device name, if the file is not on disk 

3. The directory name, if the file is not in your disk area 
The following information is optional in a file specification: 

1. The file name extension 

2. The device name, if the file is on disk 

3. The directory name, if the file is in your disk area 

4. The protection code 
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The following are examples of file specifications: 



TEXT. MAC 

DTA3:FILEA 

DSK:PROG2.CBL[10,16] 

DSKA:MAIN.F4[27 f 235] <057> 



File name and file name extension 

Device name and file name 

Device name, file name, file name 
extension and directory name 

A complete file specification: 
device name, file name, file name 
extension, directory name, and 
protection code. 



1.4.2.5 Wildcard Constructions - You can use wildcard constructions 
with many command strings. A wildcard exists when you type an 
asterisk to specify a file specification field or a question mark to 
replace a character in a file specification field. You use the 
asterisk (*) as a wildcard to designate the entire file specification 
field. For example: 



filename. * 

*.ext 

* . * 

* .* [project,*] 



All files with this file name 
extension 



and 



any 



All files with this extension and any file 
name 

All files 

All files in directories with this project 
number and any programmer number 



You can use the question mark as a wildcard to designate a part of a 
file specification field. You type a question mark for each character 
that is to be matched. For example, PR?? matches on four characters 
or less. 



filename. M?? 

TES??.ext 

??.??? 

[25,5??] 



All files with this file 
extension beginning with M 



name 



and any 



All files with this extension and any file 
name up to five characters, beginning with TES 

All files with file names of two characters or 
less and file name extension of three 
characters or less. 

All files in directories with the project 
number 25 and a programmer number 500 through 
577 

You can specify the asterisk and the question mark in the same command 
construction: 

??.* All files with file names of two characters or less 
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Also, you can specify a directory name with the project number, the 
programmer number, or both numbers missing from the specification. 
The following examples represent directory specifications. 

[15,23] The UFD [15,23] 

[,30] The UFD that has the your project number and 

the specified programmer number (i.e., 30) 

[36,] The UFD that has the specified project number 

(i.e., 36) and your programmer number 

[,] Your UFD 

[-] Your default directory which may be different 

from Your UFD. (Refer to the SETSRC 
description in DECsystem-10 Monitor Calls ) 

[ , ,SUBl,SUB2] The sub-file directory SUB2 under the sub-file 

directory SUBl in your UFD 

The DUMP, DIRECT, and QUEUE programs recognize the number sign as 
described below. (Refer to the PIP Programmer's Reference Manual for 
PIP's interpretation of the number sign.) You can use a number sign 
to represent a file name or extension that contains characters that 
cannot be typed because they have special meanings in the system. For 
example, if you were to type *.MAC in a command string, you would be 
referencing all files with the .MAC extension. You can use the number 
sign followed by the octal representation of the file name or 
extension in SIXBIT code to allow a file name or extension composed of 
special characters to be typed. For example, 120000000000 represents 
the file named *. If letters or digits are part of the file name or 
the extension containing the special characters, you must also type 
the octal representation of the letters or digits following the number 
sign. Therefore, you must type the number sign at the beginning of 
the file name and all characters following it must be represented in 
SIXBIT. Appendix F contains a table of SIXBIT character codes. 



1.4.2.6 Date-Time Arguments - Certain switches require arguments 
specifying a date or time. Date and time arguments can be either 
relative or absolute. A relative argument specifies a certain length 
of time from the current date or time; an absolute argument specifies 
a particular date or time. The format of a relative argument is shown 
below; 

numbe r-of -day sD: hours: minutes: seconds 

where: number-of-days is optional. 

D is required if you specify number of days. 

hours is optional if you specify number of days (with the 
letter D) . Otherwise, hours are required. 

minutes are optional. 

seconds are optional. However, if you specify seconds, 
minutes must also be given or seconds will be interpreted as 
the minutes argument. 
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You must type the colon to separate one field from the other. You can 
precede a relative argument with an optional plus (+) or minus (-) 
sign. If you do specify a sign, the sign implies either past (-) or 
future (+) . When you do not specify number of days, you must precede 
the time with a plus sign or a minus sign. For example: 

-3D:4:27:21 

means three days, four hours, 27 minutes, and 21 seconds ago. 
Similarly: 

+4 

means four hours from now. 

An absolute argument is written in the following format: 

weekday or date:hours:minutes: seconds 

where: weekday is the day of the week and it is optional. 

date is optional and has one of the following formats: 

day of month-month-year (21-OCT-76) 

month-day of month-year (OCT-21-76) 

numeric month-day of month-year (10-21-76) 

The month can be truncated to a unique abbreviation. The 
year (and its preceding hyphen) is optional and, if given, 
can be one, two, or four digits. 

hours is based on a 24-hour clock and it is required 

minutes is optional 

seconds is optional 

For example, the following specifies before or since last Wednesday at 
9:15:6 A.M. 

WED:09:15:6 

Because the date is known to be past or future from either the switch 
used (e.g., BEFORE and SINCE imply past; AFTER implies the future) or 
by the plus or minus sign, an unspecified field is filled in so that 
the result is the next or last occurrence of the specified date. 
Therefore, if you omit the time argument, the time defaults to 
00:00:00 (midnight) if past and 23:59:59 (11 o'clock, 59 minutes, and 
59 second P.M.) if future. Therefore: 

/AFTER:SAT is after 23:59:59 next Saturday 

/BEFORE :25-FEB is before last February 25th 

/SINCE: JUL-3-76 is since July 3, 1976 at noon 
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1.4.3 Option Files 

You can create files in your disk area into which you can put switches 
for the DIRECT, DUMP, LINK-10, LOGIN, INITIA, and QUEUE programs. 
These files allow you to automatically override system defaults for 
the individual programs. 

This file is called DSK: SWITCH. INI and it must reside in your disk 
area. It can contain two types of lines. The first type is written 
in the following format. 

program-name/switch/switch/. . ./switch 

where: program-name is either DIRECT or DUMP. 

/switch is a valid switch for the named program (i.e., 
/DIRECT, /DETAIL, /NOSUMMARY) . 

You can place only one line per program in the file. However, this 
line may be as long as you wish by putting the hyphen continuation 
character before the carriage return. When you run the named program, 
the switches in SWITCH.INI will be used as the defaults instead of any 
system-defined defaults. When the system calls in the program, it 
searches for your file called SWITCH.INI. If the system does not find 
the file, the system uses any system defaults for that program. If 
the system finds the file, but does not find a line for the specified 
program, the system uses any system-defined defaults. When the system 
finds your SWITCH.INI file and it contains a line for the specified 
program, the system uses the switch values that you have specified in 
the SWITCH.INI file instead of any system-defined default values. 

You can override any switch in your SWITCH.INI file by issuing a 
command string to the specified program containing a complement of the 
switch in SWITCH.INI. 

The second type of line that can appear in your SWITCH.INI file is 
written in the following format: 

program-name:option-name/switch/switch. . ./switch 

where: program-name is a program name such as DIRECT, DUMP, LINK-10, 
LOGIN, INITIA, or QUEUE. 

option-name is the same as used for the /OPTION switch. 
(Refer to the DIRECT and DUMP command descriptions in Chapter 
2.) 

You use the second type of line to override both system defaults and 
any defaults that you may have previously specified. You reference 
this type of line in SWITCH.INI by including the /OPTION: option switch 
in a command string to a program. If you specify an option name in 
the command string that does not appear in SWITCH.INI, the program 
outputs a warning message and uses the system defaults for that 
program. 

Assume that you create a file called SWITCH.INI that contains: 

DIRECT/FAST/UNITS/SUMMARY 
DIRECT: THIS RUN/WORDS/ACCESS : 25 

If you then type the DIRECT command, the system will print a fast 
listing showing both the actual unit names (instead of the structure 
names) and the summary line. When you desire the system to print a 
normal directory listing, you must type a command string to DIRECT 
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that includes the /NORMAL switch. Note that disk unit names, not 
structure names, and the summary line will still be output. You can 
type the following command string to automatically list the length of 
the files in words, instead of blocks, and to update the access date 
of files with 25 words or less: 

DIRECT/OPTION: THIS RUN 



1.5 COMPIL-CLASS COMMANDS 

You can type short, concise command strings that cause a series of 
options to be performed. These commands are known as COMPIL-class 
commands; they are described in detail in Chapter 2. These commands 
cause the monitor to run the COMPIL program, which deciphers the 
command and constructs new commands strings for the system program 
(e.g., TECO, PIP, LINED, SOS, FORTRAN) that actually process the 
command. Each time you execute the CREATE, MAKE, EDIT, or TECO 
commands, the command with its arguments is written as a temporary 
file in core or on the disk. Therefore, the system can recall the 
file specification last edited for the next edit without your having 
to specify the arguments again. Note that this is an exception to the 
requirement that the file name must always be specified. For example 
if you type: 

.CREATE PROGX.MAC 
You may then later type the following: 

.EDIT 
instead of the following command line: 

.EDIT PROGX.MAC 

assuming that you have not issued another EDIT-class command changing 
the file name in the interim. 

The system also writes the COMPILE, LOAD, EXECUTE, and DEBUG commands, 
with their arguments, in a temporary file, allowing your last file 
specification to be recalled without again specifying the arguments. 

The temporary files containing these file specifications have file 
names written in the following format: 

nnnxxx.TMP 

where: nnn is your job number in decimal, with leading zeros to make 
three digits. 

xxx specifies the use of the file. 

(Refer to Appendix C for a list of the temporary files.) 



1.5.1 Indirect Commands (@ Construction) 

When you have to input many program names and switches, you can put 
these into a file, eliminating the need for you to retype the names 
and switches for each compilation. You do this by using the @ file 
construction, which you can combine with any COMPIL-class command. 
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You can specify an @ file at any point in a command line after the 
first word in the command. In this construction, the word file must 
be a file name, followed by an optional file name extension and 
project-programmer number. If you omit the extension, the system 
searches for a command file with a .CMD file name extension. If that 
file is not found, it then searches for a command file with a null 
extension. Then, when the system finds the specified file, it places 
the information in the file into the command string, replacing the 
^filename. 

For example, if you have a file called @FLIST containing the following 
command string: 

FILEB,FILEC/LIST, FILED 
then, the following command line: 

.COMPILE, FILEA,FILEB,FILEC/LIST, FILED, FILEZ 
could be replaced by the following command line: 

.COMPILE FILEA,@FLIST, FILEZ 

You may have command files containing the @ file construction to a 
depth of 17 levels. If this process of indirection results in files 
pointing in a loop, the maximum depth is rapidly exceeded, and the 
system prints an error message. 

The following rules apply in handling format characters in a command 
file. 

1. Spaces are used to delimit words, but otherwise are ignored. 
Similarly, a TAB, a vertical TAB, and form feed characters 
are treated as spaces. 

2. To allow long command strings, command terminators (i.e., 
carriage return, line feed, ESCAPE) are ignored if the first 
nonblank character after a sequence of command terminators is 
a comma. Otherwise, they are treated either as commas by the 
COMPILE, LOAD, EXECUTE, and DEBUG commands, or as command 
terminators by all other COMPIL-class commands. 

3. Blank lines are ignored completely. 

4. Comments can be included in command files by preceding the 
comment with a semicolon; text from the semicolon to the end 
of the line is ignored. 

5. If command files are sequenced, the sequence numbers are 
ignored. 



1.5.2 The + Construction 

When you use the + construction, the system produces a single 
relocatable binary file from a collection of input source files. If 
you wish to construct a single program from several input files, you 
can name one input file FIRST. MAC, another MIDDLE. MAC, and a third 
LAST. MAC. You can then specify the following command line: 

.COMPILE FIRST+MIDDLE+LAST 
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After this, the system produces one binary file produced from the 
three source files, FIRST, MIDDLE, and LAST. This construction allows 
you to use one input file as part of several different compilations. 
For example, you could later use the FIRST. MAC file with SECOND. MAC 
and THIRD. MAC to obtain a different binary file. The + construction 
permits you to maintain material in a single file that is common to 
more than one compilation. 

The system gives the name of the last input file in the string to any 
output file (i.e., .REL, .CRF, .LST). Therefore, in the previous 
examples, the output files would be called LAST and THIRD, 
respectively. Note that you can include device names, extensions, and 
project-programmer numbers in any + construction. Therefore, the 
following is a valid command string: 

.COMPILE FIRST. MAC [27, 4072] +SECOND.MAC+THIRD. MAC [35, 234] 



1.5.3 The = Construction 

Usually the system makes the name of the relocatable binary file the 
same as that of the source file, with the extension specifying the 
difference. You can override this action by using the = construction. 
The = construction allows you to specify the name of the output files. 
For example, if you need a binary file called BINARY. REL from a source 
program called SOURCE. MAC, you could issue the following command line: 

.COMPILE BINARY=SOURCE 

You can also use this construction to specify an output name for a 
file produced by the use of the + construction. To give the name 
WHOLE. REL to the binary file the system produces with PARTI. MAC and 
PART2.MAC, you could issue the following command line: 

.COMPILE WH0LE=PART1 + PART2 

To change the file name of the output file is the most common use of 
the = construction. However, you may also use it to change any other 
default condition. The default condition for processor output is 
DSK: source. REL [your ppn] . If you would like output on DTA3 with the 
file name FILEX instead of the defaults, you could issue the following 
command line: 

.EXECUTE DTA3:FILEX=FILE1.F4 



1.5.4 The < > Construction 

The < > construction can be used in COMPILE, LOAD, EXECUTE, and DEBUG 
commands only. You use it to cause programs listed within the angle 
brackets to be assembled with the same parameter file. If you also 
use the + construction, it must appear before the < > construction. 
To assemble LPTSER.MAC, PTPSER.MAC, and PTRSER.MAC with the PAR. MAC 
parameter file, you could type the following command line: 

.COMPILE PAR+LPTSER,PAR+PTPSER,PAR+PTRSER 

However, using the < > construction you could merely type the 
following line: 

.COMPILE PAR + <LPTSER, PTPSER, PTRSER> 
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The following command string construction is invalid 
.COMPILE <LPTSER, PTRSER, PTPSER> + PAR 



1,5.5 Compile Switches 

You can modify the COMPILE, LOAD, EXECUTE, and DEBUG commands by 
including switches in the command string. The switches can be used to 
perform the following: 

1. Indicate the processor to be used 

2. Force a compilation 

3. Generate listings 

4. Create libraries 

5. Search user libraries 

6. Obtain loader maps 

You precede each switch with a slash and terminate it with a 
non-alphanumeric character, usually a space or a comma. You can 
abbreviate the switch if the name remains unique. 

The switches used are either temporary or permanent. A temporary 
switch applies only to the immediately preceding file. You cannot 
place an intervening space or comma between the file name and the 
switch. In the command construction: 

.COMPILE PROG, TEST/MACRO, SUBLET 

the /MACRO switch applies only to the file named TEST. 

A permanent switch applies to all files following it, until you modify 
it by a subsequent switch. You separate the switch from the file name 
by spaces, commas, or a combination of both. In the command 
construction: 

.COMPILE PROG/MACRO TEST, SUBLET ; temporary switch that 

; affects PROG 

.COMPILE PROG, /MACRO, TEST, SUBLET ;permanent switch that 

; affects TEST and SUBLET 

.COMPILE PROG, /MACRO TEST, SUBLET ; permanent switch that 

; affects TEST and SUBLET 

.COMPILE PROG/MACRO, TEST, SUBLET ; temporary switch that 

; affects PROG 

The COMPILE, LOAD, EXECUTE, and DEBUG command descriptions in Chapter 
2 list their applicable switches. 



1.5.6 Standard Processor 

The system always translates files with recognizable extensions 
implied by the extension (i.e., .MAC, .CBL, .F4, .ALG) , even if you 
type a switch directing otherwise. The COBOL compiler will process a 
file called DATPRO.CBL. Files without a recognizable processor 
extension are compiled or assembled according to the standard 
processor, normally FORTRAN, at the beginning of the command string. 
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You can control the setting of the standard processor by including 
switches in the COMPILE, LOAD, EXECUTE, or DEBUG command string. The 
descriptions of the COMPILE, LOAD, EXECUTE, and DEBUG commands in 
Chapter 2 include descriptions of the switches used to change the 
standard processor. 

In the following examples, the installation has chosen FORTRAN as the 
standard processor. If you issue the following command: 

.COMPILE NOEXT 

the file named NOEXT will be compiled by FORTRAN. The following 
command: 

.COMPILE FILEZ.MIN 

causes the file named FILEZ to be compiled by FORTRAN because MIN is 
not a recognizable processor extension. The following command: 

.COMPILE APART, DATA/COBOL, TEST 

causes the files APART and TEST to be compiled by FORTRAN and the file 
DATA to be compiled by COBOL. 

NOTE 

By setting the appropriate assembly 
switches, SNOBOL, BLISS, and MACYll will 
be recognized as processors. However, 
these assembly switches are not 
supported. 

The switches used to change the standard processor can be temporary or 
permanent. (Refer to Section 1.5.5.) The command construction: 

.COMPILE APART, /COBOL DATA, TEST 

causes APART to be compiled by FORTRAN, and DATA and TEST to be 
compiled by COBOL. 

If you specify source files with appropriate extensions, you can 
disregard the subject of the standard processor. Any files you 
specify with a processor extension are always translated by the 
specified processor, even if you type the switch name. 



1.5.7 Processor Switches 

It is occasionally necessary for you to pass switches to the assembler 

or compiler in a COMPILE, LOAD, EXECUTE, or DEBUG command. For each 

translation (assembly or compilation) , the COMPIL program sends a 
command string to the translator, containing three parts: 

1. Binary output file 

2. Listing file 

3. Source file 
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To include switches with these files, you must do the following: 

1. Group the switches according to each related source file if 
you use the + construction. 

2. Group the switches according to the three types of files for 
each source file; the order of the groups of switches is 

a. binary 

b. listing 

c. source 

3. Separate the groups of switches by commas for each source 
file. 

4. Enclose all switches for each source file within one set of 
parentheses. 

5. Place each parenthetical string immediately after the source 
file to which it refers. 

The COMPIL program interprets the groups of switches, using these 
rules: 

1. The switches immediately before a closing right parenthesis 
are source (SSSS) . 

2. The switches before the first comma are binary (BBBB,,). 

3. The switches before the second comma are listing (LLLL,). 

4. The order of the switches is BBBB, LLLL, SSSS. 

5. The individual switches are separated by spaces. 

The following are examples: 

(SSSS) source switch 

(BBBB,,) binary switch 

(BBBB, LLLL, SSSS) binary, list, and source switches 

(,,SSSS) source switch(es) 

(,LLLL,) listing switch(es) 

(BBBB,, SSSS) binary and source switches 

(BBBB, LLLL,) binary and list switches 

(, LLLL, SSSS) list and source switches 

The processor switches are listed in Table 1-2, with their meanings 
and the types of files to which they apply. 

The following are examples of the use of processor switches: 

.DEBUG TEST(,N,) Suppresses error message 

during assembly. 

.COMPTLE OUTPUT=MTA0: (S,M,W)/L Rewinds the magtape (W) , 

compiles the first file, 
produces binary output for the 
KI10 (S) , and includes the 
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MACRO coding in the output 
listing file (M) . Output 
files are given the names 
OUTPUT. REL and OUTPUT. LST. 



COMPILE/MACRO A=MTA0 : ( ,Q , W) /L 



COMPILE/MACRO A=MTA0 : ( , Q , ) /L 



Rewinds the magtape (W) , 
compiles the first file, and 
suppresses Q (questionable) 
error indications in the 
listing. When a binary switch 
is not present, the delimiting 
comma must appear. 

Compiles the file at the 
current position of the tape 
and suppresses Q error 
indications on the listing. 
Note that when the source and 
binary switches are not 
present, the delimitng commas 
must appear. 



COMPILE FOO (NOWARN DEBUG) 



Compiles the file named FOO 
using the F10 source switches 
NOWARN and DEBUG. 



Table 1-2 
Processor Switches 



Processor 


Binary 


Listing 


Source 


Meaning 


ALGOL 


D 


N 


L 

Q 
S 


Set dynamic storage region 
for your own array (knwon as 
the heap) . E The source 
file has line number in 
columns 73 to 80. 

List the source program. 

Suppress error message on 
the terminal. 

Delimit the words in quotes. 

Suppress the listing of the 
source program. 


COBOL 


A 


A 
C 


A 


Allow the listing of code 
generated. 

Produce a cross-referenced 
listing of all user-defined 
items in the source program. 




E 


E 


E 


Check the program for 
errors, but do not generate 
code. 
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Table 1-2 (Cont.) 
Processor Switches 



Processor 


Binary 


Listing 


Source 


Meaning 




I 






Suppress generation of the 
starting address of a main 
program. 




J 




L 


Force a starting address to 
be generated for a 
subprogram. 

Use the preceding file 
descriptor as a library file 
whenever the COPY verb is 
encountered. 




M 


M 
N 


M 


Print a map showing the 
parameters of the 
user-defined item. 

Suppress output of source 
errors on the terminal. 




P 






Do not generate trace calls 
and symbols. 




R 






Produce a two-segment object 
program. The high segment 
contains the resident 
sections of the Procedure 
division; the low segment 
contains everything else. 
When the object program is 
loaded, LIBOL is added to 
the high segment. 




S 


S 


S 


The source file has sequence 
numbers in columns 1 through 
6 and comments starting at 
column 73. 




W 


W 


w 


Rewind the magnetic tape. 




z 


Z 




Zero the DECtape directory. 


FORTRAN 


A 


A 


A 


Advance the magnetic tape 
reel by one file. 




B 


B 
C 
D 


B 


Backspace the magnetic tape 
reel by one file. 

Generate a CREF-type 
cross-reference listing. 

List error message codes 
only. 
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Table 1-2 (Cont.) 
Processor Switches 



Processor 


Binary 


Listing 


Source 


Meaning 




S 


E 

I 

M 
N 




Print an octal listing of 
the binary program in 
addition to the symbolic 
listing. This switch must 
be accompanied by the M 
switch. 

Translate the letter D in 
column 1 as a space , and 
treat the line as a normal 
FORTRAN statement. 

Include MACRO coding in 
output listing. 

Suppress output of error 
messages on the terminal. 

Produce code for execution 
on the KA10 if running on 
the KI10, and vice versa. 




T 


T 


T 


Skip to the logical end of 
the magnetic tape. 




W 


W 


W 


Rewind the magnetic tape. 




Z 


Z 




Zero the DECtape directory. 


FORTRAN- 10 


KA 
KI 


E 
M 


C 

I 


Generate a file that can be 
input to the CREF program. 

Include the octal-formatted 
version of the object file 
in the listing. 

Translate the letter D in 
column 1 as a space, and 
treat the line as a normal 
FORTRAN statement. 

Compile the program, 
producing code to execute on 
the KA10 processor. 

Compile the program, 
producing code to execute on 
the KI10 processor. 

Add the mnemonic translation 
of the object code to the 
listing file. 






NOE 


NOE 


Suppress output of error 
messages to the terminal. 






NOW 


NOW 


Suppress output of warning 
messages to the terminal. 
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Table 1-2 (Cont.) 
Processor Switches 



Processor 


Binary 


Listing 


Source 


Meaning 









S 


Perform optimization of 
global symbols when 
producing processor code. 

Perform compilation, 
checking for syntax errors 
only. 


MACRO 


A 


A 


A 


Advance the magnetic tape 
reel by one file. 




B 


B 
C 

E 
F 

G 

L 

M 

N 


B 


Backspace the magnetic tape 
reel by one file. 

Produce listing file in a 
format acceptable as input 
to CREF. 

List the macro expansions. 

Byte sizes match the format 
of the instruction. 

Byte sizes are two 18-bit 
fields. 

Reinstate listing (used 
after list suppression by S 
switch) . 

Suppress ASCII test in macro 
and repeat the expansion 
(SALL) . 

Suppress error messages on 
the terminal. 













Allow literals to occupy 
only one file. 




P 






Increase the size of the 
pushdown list. 




Q 


Q 
S 


Q 


Suppress questionable (Q) 
error indications on the 
listing. 

Suppress the listing. 




T 


T 
X 


T 


Skip to the logical end of 
the magnetic tape. 

Suppress all macro 
expansions. 






Z 


Z 


Zero the DECtape directory. 
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1.5.8 Switches To The Linking Loaders 

Two linking loaders are available to you on the DECsystem-10 : the 
LOADER program and the LINK-10 program. (Refer to the LOADER 
Programmer's Reference Manual and the LINK-10 Programmer's Reference 
Manual for complete information.) In complex loading procedures, it 
may be necessary to pass switches to one of the linking loaders to 
direct its operation. The percent sign (%) character accomplishes 
this passing of switches. 



1.5.8.1 Passing LOADER Switches - The % character takes an optional 
leading sign (+ or -) and one letter (or a sequence of digits and one 
letter) following it. To set a program origin of 6000 for file PROG 3 , 
you can type the following: 

.LOAD PROGl,PROG2,%6000OPROG3,PROG4 

The %6000O switch, with the % character replaced with the / character, 
is passsed to the LOADER. The COMPIL program allows more than one 
LOADER switch to be specified: 

.LOAD PROG %F/MAP 



(For a description of the /MAP 
description in Chapter 2.) 



switch, refer to the LOAD command 



1.5.9 Passing LINK-10 Switches 

The LINK-10 switch specification, preceded and followed by a 
delimiter, follows the % character. The delimiter can be any 
character; however, you must be careful that the character you use 
does not have a specific meaning to COMPIL. The @ character indicates 
an indirect command file, and the semicolon causes the remainder of 
the line to be treated as a comment and, therefore, is ignored. The 
recommended delimiter is a single or double quotation mark. The 
beginning and ending delimiter must be the same character. 

A LINK-10 specification consists of the switch name and, optionally, a 
keyword and a value. The items in the specifications are separated by 
colons. To set a program origin of 6000 for file FILEB, you could 
type the following command: 

.LOAD/LINK FILEA, %' SET: . LOW. : 666 ' FILEB, FILEC 



(For a description of the /LINK switch, 
description in Chapter 2.) 



refer to the LOAD command 
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CHAPTER 2 
SYSTEMS COMMANDS AND PROGRAMS 



Although there is one operating system for all configurations of the 
DECsystem--10, some commands may not be included in every DECsystem-10 . 
Some installations delete certain features from their operating 
systems because of a constraint on core. Your system administrator 
can delete commands from the operating system by setting feature test 
switches when defining the system configuration via MONGEN. 

In many cases, you can type one of two commands to run a program. For 
example, the indirect command MAKE and the direct command R TECO both 
run Jthe TECO program. At some installations, the system administrator 
may have turned off the indirect command switch, but the switch 
implementing the direct command is always set. Therefore, you may 
always run a program with the R (or RUN) command, even if the switch 
implementing the corresponding indirect command has been turned off. 



Although commands are arranged in alphabetical order in Chapter 2 for 
ease of reference, they can be divided into functional groups for ease 
of learning. 



2.1 JOB INITIALIZATION COMMANDS 

Because the system limits access to authorized persons, the following 
commands protect the system from unauthorized use. 

INITIA Performs standard system initialization for your 
terminal. 

LOGIN Gives you, the user, access to the system. 



2.2 FACILITY ALLOCATION COMMANDS 

The monitor allocates peripheral devices, file structure storage, and 
core memory to user jobs when they request these things. The monitor 
also protects these allocated facilities from interference by other 
users. The monitor incorporates software provisions to differentiate 
the central nodes from the remote nodes. Certain commands (e.g., 
ASSIGN, PLEASE) include node identification arguments to allow both 
user access and allocation of system resources at any node. This 
feature allows you considerable flexibility in allocating system 
facilities and directing input and output to a specific node. 

By specifying a node number, you can assign devices and input data 
from a peripheral device at a node other than your own. In addition, 
by using the LOCATE command, you can logically establish your job at a 
node other than your physical node. If you do not include a node 
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identification argument in your command line, the system automatically 
directs input and output to your logical node. Your logical node is 
the same as your physical node, if you have not issued the LOCATE 
command. 



When the system assigns a n 
removes that device from 
If another user attempts to 
attempt fails. You shou 
returning your allocated fa 
facilities are automatica 
available resources when yo 
job. Until you return thes 
utilize them except through 



onsharable device to your job, the system 

the monitor's pool of available resources. 

reference or assign that device, the 

Id never leave the system without first 

cilities to the monitor pool. Allocated 

lly returned to the monitor's pool of 

u deassign the resources or you kill your 

e facilities (resources) , no other user can 

operator intervention. 



Assignable devices (i.e., nondisk and nonspooled devices) in the 
monitor's pool of available resources are either unrestricted or 
restricted devices. Any user can assign an unrestricted device by 
using the ASSIGN command. Only privileged jobs (i.e., jobs logged in 
under [1,2] or running with the JACCT bit set) can assign restricted 
devices. However, nonprivileged users can have a restricted device 
assigned to them via the MOUNT command. The MOUNT command allows 
operator intervention for the selection or denial of a particular 
device; therefore, the operator controls the use of the assignable 
devices. This is particularly useful when there are multiprogramming 
batch and interactive jobs competing for the same devices and 
resources. The operator sets or removes the restricted status of a 
device via the OPSER commands : RESTRICT and :UNRESTRICT. 

The facility allocation commands are listed below. 

ASSIGN Allocates an I/O device to your job without operator 
intervention. 

CLOSE Terminates I/O in progress on a specified device, but 
does not release the device. 

CORE Types or modifies the amount of core assigned to your 
job. 

DEASSIGN Returns devices assigned to your job to the monitor's 
pool of available devices. 

DISMOUNT Returns, via the operator, devices assigned to your 
job to the monitor's pool of available devices. 

FINISH Terminates I/O in progress on the specified device and 
performs the RELEASE monitor call or the DEASSIGN 
command. 

LOCATE Establishes your job at a specified node. 

MOUNT Allocates an I/O device to your job via the operator. 

NODE Associates a node name with a particular device. 

REASSIGN Gives the specified device to the designated job. 

SET Sets the default block size for the specified magnetic 
BLOCKSIZE tape unit. 

SET CDR Sets the file name for the next card reader spooling 
interrupt. 
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SET CPU Sets the CPU specification (i.e., CPxn, NO CPxn, ALL, 
ONLY CPxn) for your job. 

SET Sets the default density for the specified magnetic 
DENSITY tape unit. 

SET DSKPRI Sets the priority for your job's disk operations (data 
transfers and head positionings) . 

SET HOST Sets the central node for your job. 

SET HPQ Sets the high priority scheduler run queue for your 
job. 

SET PHYSIC Sets the maximum current physical page limit or 
guideline on a virtual memory system. 

SET RETRY Enables or disables error retry on a specified 
magnetic tape unit. 

SET SPOOL Adds devices to or deletes devices from the list of 
spooled devices for your job. 

SET TTY Sets properties to be associated with your terminal. 

SET VIRTUA Sets the current virtual page limit on a virtual 
memory system. 



2.3 SOURCE FILE PREPARATION COMMANDS 

These commands call the system editing programs to create or edit a 
specified text file. The system editing programs available are LINED 
(a line-oriented editor) and TECO (a character-oriented editor). In 
general, the editor that you use to create a file should also be used 
when you edit the file, since LINED requires line-blocked files and 
TECO does not. 

CREATE Opens a new file on disk for creation with LINED. 

EDIT Opens the specified file, already existing on disk, 
for editing with LINED. 

MAKE Opens a new file on disk for creation with TECO. 

TECO Opens a specified file that already exists for editing 
with TECO. 



2.4 FILE MANIPULATION COMMANDS AND PROGRAMS 

The commands and programs in this group allow you to manipulate files 
to any extent desired. You can list source files, DECtape 
directories, and disk directories on your terminal or the line 
printer, possibly via the spooling mechanism. You can delete or 
rename files from disk and DECtape. You can also transfer files 
between standard I/O devices, perform conversion between various core 
image formats, and read and write various directory files. You can 
allocate disk space for a new file or you can reallocate disk space 
for an existing file. Finally, you can place files in the system 
queues and obtain listings of entries in these queues. 
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ALCFIL Allocates space for a new file or reallocates space 
for an existing file. 

BACKSPACE Spaces a magnetic tape backward the specified number 
of files or records. 

BACKUP Saves and restores disk files. 

COPY Transfers files from one device to another. 

CPUNCH Places entries into the card punch output spooling 
queue. 

DELETE Deletes files from DECtape or disk. 

DIRECT Lists the directory entries for the specified 
arguments. 

DTCOPY Copies the contents of one DECtape to another. 

EOF Writes an end-of-file mark on the specified magnetic 
tape. 

FAILSA Saves and restores disk files. 

FILCOM Compares two versions of a file and outputs any 
differences. 

FILE Provides remote control via the operator for 
DECtape-to-disk and disk-to-DECtape transfers. 

GLOB Reads multiple binary files to produce an alphabetical 
cross-referenced listing of all global symbols 
encountered. 

LABEL Writes an identifier on a DECtape. 

LIST Writes the specified files on the line printer. 

MTCOPY Copies entire contents of selected files from magnetic 
tapes. 

PLOT Places entries into the plotter output spooling queue. 

PRESERVE Renames the specified files with the standard 
protection inclusively ORed with 100. 

PRINT Places entries into the line printer output spooling 
queue. 

PROTECT Renames the specified files with the requested 
protections. 

QUEUE Enters items into the specified system queue. 

RENAME Changes one or more items of the file specification of 
files on DECtape or disk. 

REWIND Rewinds a magnetic tape or a DECtape. 

SET Sets the default protection of a file. 
DEFAULT 
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SKIP Moves the specified magnetic tape forward the 
designated number of files or records or to the 
logical end of the tape. 

SUBMIT Places entries into the batch input queue. 

TPUNCH Places entires in the paper-tape punch output spooling 
queue. 

TYPE Types the specified files on your terminal. 

UNLOAD Rewinds and unloads the specified magnetic tape or 
DEC tape. 

ZERO Clears the directory of the specified device. 



2.5 OBJECT PROGRAM PREPARATION COMMANDS AND PROGRAMS 

The commands and programs in this group are used to prepare object 
programs and save your core area as one or two files. 

COMPILE Produces relocatable binary files (.REL extensions) 
for the specified source files. 

CREF Lists on the line printer any cross-referenced listing 
files generated by a previous COMPILE, LOAD, EXECUTE, 
or DEBUG command. 

DEBUG Produces relocatable binary files for the specified 
source files, loads the .REL files, and prepares for 
debugging with DDT. 

EXECUTE Produces relocatable binary files for the specified 
source files, loads the .REL files, and begins 
execution. 

FUDGE Creates a library .REL file by reading a temporary 
file generated by a previous COMPILE, LOAD, EXECUTE, 
or DEBUG command. 

LOAD Produces relocatable binary files for the specified 
files and loads the .REL files generated. 

MAKLIB Updates the files containing relocatable binary 
programs and manipulates programs within the program 
files. 

OSAVE Writes a core image of your core area on the specified 
device. 

NSAVE Writes a core image of your core area on the specified 
device. 

OSSAVE Writes a core image of your core area on the specified 
device. When loaded with GET (or RUN) the high 
segment will be sharable. 

NSSAVE Writes a core image of your core area on the specified 
device. When loaded with GET (or RUN) the high 
segment will be sharable. 
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2.6 OBJECT PROGRAM CONTROL COMMANDS 

By using commands in this group, you can load core image files from 
retrievable storage devices (ie., disk, DECtape, magnetic tape). 
These files can be retrieved and controlled from your terminal. You 
address files stored on disk and DECtape by file name. To reference a 
file on a magnetic tape, you must pre-position the tape to the 
beginning of the file. (Refer to DECsystem-10 Monitor Calls for a 
description of the job data area location referenced by the command 
descriptions in this group of commands.) 

CCONT Continues the program from the point at which you 
interrupted it, but leaves your terminal in monitor 
mode. 



CONT 



Continues the program from the point at which you 
interrupted it. 



CSTART Begins the execution of a program that you loaded 
either with a GET command or that you interrupted, but 
leaves your terminal in monitor mode. 



DDT 



GET 



HALT 



Copies the saved program counter and then starts the 
program at the beginning address of DDT. 

Loads a core image from the specified device, but does 
not begin execution. 

Stops your job and stores the program counter in the 
job data area. 



JCONT Continues the specified job, if it was waiting for 
operator intervention. 



R 



REENTER 



RUN 



Loads a core image from the system device (:SYS) and 
starts it at the location specified in the file. 

Starts the program at an alternate entry point 
specified by the program. 

Loads a core image from the specified device and 
starts it at the location specified in the file. 



SET BREAK Halts a program at a specified location on various 
conditions. 



SET Controls your job when you have exhausted 
DSKFUL assigned disk space. 



your 



START Begins execution of a program that you either 
previously loaded with the GET command or interrupted. 



2.7 OBJECT PROGRAM EXAMINATION COMMANDS 

The commands in this group help you to examine and analyze an object 
program. Dumps of your core area can be taken, and later processed by 
the system program DUMP, according to the arguments you specify. 

D(eposit) Deposits information in your core area. 

DCORE Writes a core image file in your core area. 
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Writes a core image file and analyzes the written file 
to provide printable output. 



E(xamine) Examines the specified core location in your area. 



2.8 MULTIPLE JOB CONTROL COMMANDS AND PROGRAM 

There is not necessarily a one-to-one relationship between jobs and 
terminals. A terminal must initiate a job, but either you, the 
terminal user, or the operator may issue commands to permit a job to 
float in a detached state, where it is not associated with a 
particular terminal. More than one job may be controlled from the 
same terminal. 

ATTACH Detaches your current job and connects your terminal 
to the specified detached job. 

CCONT Continues your program from the point at which you 
interrupted it, leaving your terminal in monitor mode. 

CSTART Begins execution of a program that was either loaded 
with the GET command or was interrupted, leaving your 
terminal in monitor mode. 



DETACH 

OPSER 
REATTA 



Disconnects your terminal from your job 
affecting the status of your job. 



without 



Provides multiple job control from a single terminal. 

Transfers your job from your current terminal to your 
specified terminal. 



2.9 JOB TERMINATION COMMANDS 

When you leave the system, all facilities allocated to your job must 
be returned to the monitor's pool of available resources so that they 
will be available for other users. 



KJOB 



Gives up access to the system. 



2.10 SENDING MESSAGES 



The commands in this group allow you to communicate with other users 
of the system or with operators at any node. In addition, you may 
record information in a disk file to be read by the operations staff 
at your installation at a later time. 



GRIPE 



PLEASE 



SEND 



Accepts text from you and records it in a disk file 
for the operations staff at your installation. 

Provides two-way communication between you and the 
operator. 

Provides one-way communication. 
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2.11 JOB INFORMATION COMMANDS AND PROGRAMS 

You can obtain various job-related information with this group of 
commands. This information includes the number of your job r the 
quotas for each file structure associated with your job, and the run 
time and disk space that your job has used. In addition, you may type 
or modify your file structure search list. 

DSK Types disk usage for the combined structures of the 
specified job. 

PJOB Outputs the job number to which your terminal is 
currently attached. 

QUOLST Types the number of blocks used, the logged-in quota, 
and the logged-out quota for each file structure to 
which you have access, followed by the number of free 
blocks left on that structure. 

SETSRC Manipulates your job search list or the system's 
search list. 

SET TIME Sets the central processor time limit for your job. 

SET WATCH Sets the output of incremental job statistics. 

TIME Outputs the running time for the specified job. 

USESTAT Outputs status information pertaining to your current 
job. 



2.12 SYSTEM INFORMATION COMMANDS AND PROGRAMS 

With the commands in this group, you are able to obtain system status 
information, including the time of day, the list of available devices, 
file structures, and physical units not in file structures, the 
scheduled use of the system, and the location of a specific peripheral 
device. 



DAYTIME 



Types the current date, followed by the time of day. 



RESOURCES Outputs the names of all available devices (except 
TTYs and PTYs) , all file structures, and all physical 
units not in file structures. 

SCHED Outputs the schedule bits set by the operator. 

SYSTAT Prints system information about the current system. 

VERSION Outputs the version number of a program. 

WHERE Outputs the node number at which the specified device 
is located. 
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Function 

The ALCFIL program enables you to allocate space for a new file 
or reallocate space for an existing file in one contiguous region 
on the disk. The size of the region is restricted by the size of 
the cluster counter field (usually 512) times the cluster size of 
the file structure times the number of pointers in a disk device 
data block (not less than 10). 

Command Format 

R ALCFIL 

The ALCFIL program responds with 

/H FOR HELP 
FILE? 

You may respond with one of the below. 

dev: f ile.ext [project, prog rammer] 
or /H (for help) 
or /X (to exit) 

where dev: is a file structure name or a physical unit name. If 
you omit dev:, the system assumes DSK. If you omit one of the 
other arguments, the system assumes 0. If you specify a file 
name, the system allocates the number of blocks currently 
allocated. ALCFIL responds with the following. 

ALLOCATE? 

You may type n or n,m (decimal numbers) 

n = total number of blocks to be allocated for the file. 

m = logical block within the file structure or unit 
(depending on the device you specified) where the system 
begins allocation. 

If the system cannot allocate the total number of blocks that you 
requested, the system gives you a partial allocation and prints 
the following message: 

PARTIAL ALLOCATION ONLY 

You can issue the DIRECT command with the ALLOCATE switch to 
determine the number of blocks that the system allocated. If the 
system can allocate all of the blocks that you requested, it 
prints the following message: 

ALLOCATED 

Because the system executes an extended ENTER to allocate the new 
blocks, the file does not have to exist before the system can 
allocate the blocks. (Refer to DECsystem-10 Monitor Calls for a 
description of the extended ENTER monitor call.) 
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Characteristics 

The R ALCFIL command: 

Places your terminal in user mode. 

Runs the ALCFIL program, destroying your core image 
Example 

♦ R ALCFIL^ 



/H FOR HELP 
FILE? TEST*ALG ^/ 
ALLOCATE? 17^ 

ALLOCATED 

FILE? PRQGl.FOR V 

ALLOCATE? 10^J 

ALLOCATED 

FILE? PRQ,G1«REL V 

ALLOCATE? 1000 

PARTIAL ALLOCATION ONLY 
FILE? "Zj 
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Function 

The ASSIGN command allocates an I/O device to your job for the 
duration of the job or until you issue a DEASSIGN command. This 
command, when applied to DECtapes, clears the copy of the 
directory currently in core, forcing any directory references to 
read a new copy for the tape. (Refer to DECsystem-10 Monitor 
Calls for further details.) 

Command Formats 

(devu 
devnuu^ logical-device 
Idev 
devnn 

devu is any physical device listed in Table 1-1, followed by 
a unit number or any file structure name. The monitor 
attempts to ASSIGN the device number you specifically 
requested at your current node. (Example: LPT6). 

devnuu is any physical device listed in Table 1-1, followed 
by a 2-digit node number, followed by a unit number. The 
monitor attempts to ASSIGN the device you specified at the 
node you specified. (Example: LPT226) . 

dev is any physical device listed in Table 1-1. The monitor 
attempts to ASSIGN a device of the type you specified at 
your job's logical node. (Example: LPT). 

devnn is any physical device listed in Table 1-1, followed 
by a 2-digit node number. The monitor attempts to ASSIGN a 
device of the type you specified at the node number you 
specified. 

logical-device is a logical device name that you request be 
assigned to the specified physical device. Note that this 
argument is optional. Except for disk devices, you can 
assign only one logical name to a device. Subsequent ASSIGN 
commands to all devices except disk devices replace the old 
logical name with the new one. Logical names are 
disassociated from all devices when you issue the DEASSIGN 
command. 

Characteristics 

The ASSIGN command: 

Leaves your terminal in monitor mode. 

Restrictions 

You cannot use a comma to separate the logical and physical 
device names. If you do use a comma, the monitor terminates its 
scan at the comma; therefore, the monitor does not assign a 
logical name. 

Nonprivileged jobs (i.e., jobs not logged in as [1,2] or running 
with JACCT set) can use this command only to allocate 
unrestricted I/O devices. Nonprivileged jobs can obtain 
restricted devices by issuing the MOUNT command. A privileged 
job can allocate both restricted and unrestricted devices via the 
ASSIGN command. 
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Examples 

, ASSIGN LFT2t ^ 
LPT262 assigned 

» ASSIGN LPIX ^J 
?Assi&ned to Job 3rl 

.ASSIGN DTA2? ^ 
DTA262 assigned 

♦ ASSIGN LF,T226 <J 
?No such device 

.ASSIGN DTAOIO ^ 
?No such device 
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Function 

The ATTACH command detaches your current job and connects your 
terminal to a detached job. If you are an operator, you can 
attach your job to a device (Refer to Appendix A of DECsystem-10 
Operator's Guide . ) 

Command Format 

1. ATTACH job [pro ject, programmer ] 

job is the job number of the job to which your terminal is 
attached. This argument is required. 

[project, programmer ] is the project-programmer number of the 
originator of the desired job. You may omit this argument 
if the project-programmer number is the same as the one for 
your job. The operator (device OPR) or anyone logged in 
under [1,2] may always attach to a job although another 
terminal is attached, provided that you type the proper 
project-programmer number. 

To prevent you from attaching to jobs without knowing the 
password associated with the job, the system temporarily 
creates a new job when you specify the project-programmer 
number argument. This temporary job runs LOGIN to check the 
password. This action can result in your job being unable 
to attach to the specified job if the system's job capacity 
is exceeded by the creation of the temporary job. However, 
your job is still detached even though there are no 
available jobs. The operator or anyone logged in as [1,2] 
can always attach to another job, because privileged jobs do 
not cause the system to create a temporary job. 

2. ATTACH dev: 

This format is operator-priviliged. (Refer to the 
DECsystem-10 Operator's Guide. ) 

Characteristics 

The ATTACH command: 

Leaves your terminal in monitor mode. 
Does not require LOGIN. 

Restrictions 

Remote users cannot attach to jobs with a project number of 1. 
Batch users cannot issue this command. 



Examples 



ATTACH l ^J You attach to job 1 from job 

5. 
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FROM JOB 5 



♦ LOGIN 27 r 2 35 *J 

JOB 7 R5743A SYS #40/2 TTY 116 



The two jobs have the same 
project-programmer number; 
therefore, neither the 
project-programmer number; 
nor the password argument is 
required. 

You log in to the system. 

You are given job number 7; 
TTY number 116 is now attached 
to job 7. 



PASSWORD : 



~J 



1 034 1 7- JUNE- 1 977THUR 



♦ ATTACH 35C50> 273 ^7 

^ 



FROM JOB 7 
PASSWORD? 



You attach to an existing job (35) and detach your current 
job (7). Because the project-programmer number associated 
with job 35 is different from your project-programmer 
number, you must specify the project-programmer number 
associated with job 35. The system then requests that you 
enter the password. If you enter the correct password, the 
system attaches your terminal to job 35. 

♦ ATTACH 7 ^J 
TCAN'T ATT TO JOB 

You attempt to attach to job 7. The command fails because 
the project-programmer number belonging to job 7 is not the 
same as the project-programmer number for job 35. Your 
terminal is still attached to job 35. 

♦ K/F *J 

JOB 7t USER 1:30*273 LOGGED OFF TTY 116 L635 17-JUN-77 
RUNTIME 6 *58 SEC. 

You killed job number 35. Your terminal is currently not 
attached to any job. 

♦ ATTACH 7 ^J 
?CAN'T ATT TO JOB 

Because your terminal is currently not attached to a job, 
your command fails because there is no project-programmer 
number to compare with the project-programmer number 
associated with job 7. 

♦ A T T A C H 7 1: 2 7 > 2 3 5 3 *J 
PASSWORD? 

The system accepts the command and requests from you the 
password. The system does not print the message FROM JOBn 
because the terminal was not attached to any job. Then, the 
system attaches your terminal to job 7. 
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Function 

The BACKSPACE command spaces a magnetic tape backward a specified 
number of files or physical records. This command, depending on 
the arguments you specify, is equal to the following PIP command 
strings: 

MTAn: (M#nB)= 
MTAn: (M#nP)= 

SAVed files on magnetic tape always contain two files: a high 
segment file and a low-segment file. If one of the segments is 
missing, the system writes a null file containing one record. 
The system writes the file before the EOF for the missing 
segment. To backspace over a SAVed file, you must backspace two 
files. 

Command Formats 

1. BACKSPACE MTAn: x FILES 

skips backward x files. 

2. BACKSPACE MTAn: x RECORDS 
skips backward x records. 

Characteristics 

The BACKSPACE command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, destroying your core image. 

Examples 

♦ BACKSPACE MTAO .1. 2 1 7 RECORDS *J 

Backspaces 7 records on the tape on MTAO at node 12. 

♦ BACKSPACE MTAO .1. 3 % .1. 1 F I l-ES *J 

Backspaces 11 files on the tape on MTAO at node 13. 
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Function 

The BACKUP program saves disk files on magnetic tape and places 
all or some of these files back onto the disk. You can save your 
disk area on your own magnetic tape and restore all your files or 
a subset of your files back to your area. You can also use this 
program to move your files from one system to another. 

Command Format 

.R BACKUP 
*/switch 

BACKUP switches are described in the BACKUP Specification 
and the Monitor Installation Guide . 

Characteristics 

The R BACKUP command: 

Places your terminal in user mode. 

Runs the BACKUP program destroying your core image. 



Example 



♦ R BACKUP ^ 

/TAPE ^ 

/REMIND ^ 

/RESTORE ^ 

/UNLOADS 
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Function 

The COMPILE command produces relocatable binary files (.REL 
files) and/or compilation listings for specified source program 
files. The system determines the proper language translator to 
use by the source file extension or by switches you specified in 
the command string. If you did not supply any switches in the 
command string, the system uses the following translators: 

Source File Extension Translator Used 

.ALG ALGOL compiler 

.BLI, .BIO BLIS10 compiler 

.CBL COBOL compiler 

.F4 or .FOR FORTRAN compiler 

.FAI FAIL compiler 

.FCL FOCAL compiler 

.LSP LISP compiler 

.MAC MACRO assembler 

.Pll MACY11 assembler 

.SAI SAIL compiler 

.SNO SNOBOL compiler 

Standard translator, which is 
usually FORTRAN; refer to Section 
1.5.6. 

NOTE 

The translator cannot be changed with a 
switch but it can be specified with a 
switch when the source file has a 
nonrecognizable or null translator 
extension. For a source file with a 
recognizable translator extension, refer 
to the above list. 

Normally, the system translates the source file if there is no 
corresponding binary (.REL) file, or if the source file's date 
and time is equal to or later than the binary file's date and 
time. If the binary file is newer than the source file, the 
system does not translate the source file, and uses the current 
•REL file. You can use switches to override this action. 

NOTE 

This command runs the COMPIL program, which interprets 
the command before running the appropriate language 
translator. 

BLIS10, FAIL, FOCAL, LISP, MACYll, SAIL, and SNOBOL will 
be recognized as translators only if the appropriate 
assembly switches are set. 
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The extensions .F4 and .FOR indicate the file is a 
FORTRAN language file; they do not represent the 
particular FORTRAN compiler (either F4 or FORTRAN-10) to 
be used in the translation. The controller used is 
controlled by the switches /F40 and /F10. 

Each time you issue the COMPILE, LOAD, EXECUTE, or DEBUG 
commands, the system remembers the command, with its arguments, 
in a temporary file on disk or in core if the monitor has the 
TMPCOR features (defined via MONGEN) . When you issue one of 
these commands without an argument, it causes the system to use 
the arguments saved in the temporary file. (Refer to Section 
1.5.) 

The COMPIL command can accept a range of four command 
constructions: @ (indirect commands), +, =, and < >. (Section 
1.5 describes each construction.) 

Command Format 

COMPILE list 



list is a single file specification or a string of file 
specifications, separated by commas. The standard file 
specification consists of: a device name, a file name (with 
or without an extension), and a directory name. (Refer to 
Section 1.4.2.4.) 

You may use the following switches as temporary or permanent 
command string modifiers. (Refer to Section 1.5.5.) Only 
switches relevant to COMPIL follow; all switches allowed 
with LOAD, EXECUTE and DEBUG may be used with COMPILE; all 
others are intentionally omitted. 



Switch 



File Control Function 



/ALGOL 
/BIN 



Compile with ALGOL, 
extension is used.) 



(Assumed wherever .ALG 



Generate a binary file for each file compiled. 
The file name of the binary file follows the 
standard convention for determining the file 
name of the output file. (Refer to Sections 
1.5.2 and 1.5.3.) The extension is .REL. This 
is the default action. 



/BLISS 



/COBOL 
/COMPILE 



Compile the file with BLISS10. Assumed for 
files with the extension of .BIO and .BLI. 
BLISS10 is recognized as a translator only if 
the appropriate assembly switch is set. 
However, this assembly switch setting is not 
supported. 

Compile the fi;le with COBOL. Assumed for 
files with the extension of .CBL. 

Force a compilation on this file even if a 
binary file exists with a newer date and time 
than the source file. This switch is used to 
obtain an extra compilation (e.g., to obtain a 
listing of the compilation) because, normally, 
compilation is not performed if the binary 
file is newer than the source file. 
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Switch 
/CREF 



/FORTRAN 



/FUDGE 



/F10 



File Control Function 

Produce a cross-referenced listing file on the 
disk for each file compiled for later 
processing by the CREF program. The file name 
of the listing file follows the standard 
convention for determining the file name of 
the output file. (Refer to Sections 1.5.2 and 
1.5.3.) The extension is .CRF. The file can 
then be listed with the CREF command. 
However, with COBOL files, the 
cross-referenced listing is always appended to 
the listing file. No additional command need 
be given to obtain the listing. 



Compile the fil 
Assumed for file 
.F4 or .FOR 
nonrecognizable 
FORTRAN is the 
switch is ne 
nonrecognizable 
FORTRAN is not 
not the current 
FILEA, FILEB, FI 



e with a FORTRAN compiler. 

s with either the extension of 

and for all files with 
translator extensions, if 
standard translator. This 

eded if the file has a 

translator extension and 

the standard translator or is 

default (e.g., COMPILE/ALGOL 

LC/FORTRAN) . 



Create a disk file containing the names of the 
.REL files produced by the command string. 
When the FUDGE command is given, PIP reads 
this file to generate a library .REL file. 
(Refer to the MAKLIB User's Guide . ) Arguments 
to this switch are: 

/FUDGE :DEV: FILE. EXT [PROJ, PROG] 

dev: is the device on which to write the 
file. If you do not specify a device, the 
system assumes DSK. 

file.ext is the name of the library file. You 
must supply a file name but if you omit the 
extension, the system assumes .REL. 

[proj,prog] is the directory in which to place 
the file. Your directory is assumed if you do 
not specify one. 

This switch is permanent in the sense that it 
pertains to all .REL files generated by this 
command string. 

Use the FORTRAN-10 translator when compiling 
the associated FORTRAN file. This should be 
used as a permanent switch (i.e., placed 
before any file specifications) if loading or 
execution of the command string will be 
requested because it is not possible to load 
F40 and FORTRAN binary files together. 
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Switch 
/K?10 



/LIST 



/MACRO 
/MACY11 



/MANTIS 



/NEW 



/F40 



/NOB IN 



File Control Function 

Designate the machine on which the program 
will execute once it has been loaded. These 
switches are needed for FORTRAN-10 programs 
because the compiler generates different codes 
for the KA10 and KI10 processors. The default 
is the processor on the computer executing the 
command. The ? can be A, I, or L. 

Generate a disk listing file for each file 
compiled. The file name of the listing file 
follows the standard conventions for 
determining the file name of the output file. 
(Refer to Sections 1.5.2 and 1.5.3.) The 
extension These files can be listed later with 
the LIST command. If the line printer is 
being spooled for your job, the listing files 
are written on device LPT and are 
automatically spooled at LOGOUT time. Unless 
you specify this switch, listing files are not 
generated. 

Assemble the file with MACRO. Assumed for 
files with the extension of .MAC. 



Assemble the file with MACYll. 



Assumed for 



files with the extension .Pll. Note that 
MACYll is recognized as a translator only if 
the appropriate assembly switch is set. 
However, this assembly switch is not 
supported. 

Compile the program with the MANTIS debugging 
information. This switch affects F40 files 
only. MANTIS is recognized as the debugging 
program only if the appropriate assembly 
switch is set. However, the switch setting is 
not supported. 

Run the appropriate language translator from 
the experimental library (device NEW:) area 
[1,5]. If the translator does not exist on 
device NEW: , try to obtain it from device 
SYS: . 

Use the F40 translator when compiling the 
associated FORTRAN file. This should be used 
as a permanent switch (i.e., placed before any 
file specifications) if loading or execution 
of the command string will be requested 
because it is not possible to load F40 and 
FORTRAN-10 binary files together. 

Do not generate binary files. Unless this 
switch is given, binary files are generated. 
This switch, when combined with the /CREF or 
/LIST switch, is useful when compiling 
programs solely for the purpose of generating 
listings. 
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Switch 
/NOCOMPILE 



/NOLIST 
/NOMANTIS 

/OLD 



/SELF 



/SNOBOL 



File Control Function 

Complement of the /COMPILE switch, which does 
not force a compilation of a source file whose 
date is not as recent as the date on the 
binary file. /NOCOMPILE is the default 
action. 



Do not generate listing files, 
default action. 



This is the 



Compile the program without the MANTIS 
debugging information. This switch affects 
F40 files only. 

RUN the appropriate language translator from 
the system library of old programs (device 
OLD:), which resides on the [1,3] disk area. 
If the translator does not exist on device 
OLD:, try to obtain it from device SYS:. 

Run the appropriate language translator from 
device DSK: instead of from the system 
library (device SYS:). This switch is useful 
for an individual who keeps a private copy of 
a translator in his own disk area. System 
programmers occasionally keep experimental 
versions of standard translators in their disk 
areas to test new features. 

Compile the file with SNOBOL. Assumed for 
files with the extension .SNO. Note that 
SNOBOL is recognized as a translator only if 
the appropriate assembly switch is set. 
However, this assembly switch is not 
supported. 



Characteristics 

The COMPIL command: 



NOTE 

A language translator appearing more 
than once within a single command 
string cannot specify more than one 
disk area. For example, the following 
is illegal: 

. COMPILE TESPRG . F4/NEW, SUBRTN . F4/SYS 

However, the following is valid: 

.COMPILE TESPRG. F4/NEW 
.COMPIL SUBRTN. F4/SYS 



Leaves your terminal in monitor mode. 
Runs the appropriate language translator, 
original core image. 

Restrictions 

The wildcard construction cannot be used. 



destroying your 
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Examples 

♦ COMPILE PROG t TEST ♦ AC y MANAGE/COBOL^ 

Compiles PROG (with the null extension) with FORTRAN, 
TEST. MAC with MACRO, and MANAGE (with null extension) with 
COBOL only if REL files do not exist with later dates. A 
listing file is generated only for MANAGE. The files 
generated are PROG. REL, TEST. REL, MANAGE. REL, and 
MANAGE . LST . 

♦ COMPILE /LIST SIGN, MAC r TftBL.ES/NQLIST> MULTI ♦ ALG ^/ 

Compiles SIGN. MAC with MACRO, TABLES (with the null 
extension) with FORTRAN, and MULTI. ALG with ALGOL. Listing 
files are generated for SIGN. MAC and MULTI. ALG. 

« COMP I LE/CREF/COMP I LE D I V I BE » SUBTRC y ftDD *J 

Forces compilation of the source files although current .REL 
files exist and generate cross-referenced listing files. 
The files created are DIVIDE. CRF, DIVIDE. REL, SUBTRC. CRF, 
SUBTRC. REL, ADD. CRF, and ADD. REL. 

♦ COMP I LE /FUDGE X MON I TOR * RELEL I BALL ^7 

Compiles the files contained in the command file LIBALL and 
enters the names of all the REL files generated in a 
temporary disk file. When you issue the FUDGE command, PIP 
generates the library REL file with the name MONITOR. REL. 
The library is created with the REL files in the same order 
as they were specified in the command file. 

♦ COMPILE 0UTFUT«MTft010: (WySyM)/L ^ 

Rewinds the magnetic tape (W) , compiles the first file with 
FORTRAN, produces binary output for the KA10, and includes 
the MACRO coding in the output listing (M) . These switches 
are processor switches. (Refer to Section 1.5.7.) A listing 
file is generated with the name OUTPUT. LST along with the 
file OUTPUT. REL. 
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Function 

The CONTINUE command continues the program from the point at 
which you interrupted it. The system starts the program at the 
saved program counter address stored in .JBPC by a HALT command 
("C) or a HALT instruction. (Refer to DECsystem-10 Monitor Calls 
for a description of the job data area.) 

CTRL/C followed by CONTINUE has an unexpected result if the 
program running attempts to rescan (TTCALL 10) the current 
typed-in line after the CONTINUE. This action returns the 
CONTINUE instead of the original command. To minimize the 
probability of this occurring/ your programs that rescan the 
input line should do so at the beginning of the program to 
minimize the number of times you could type a CTRL/C. 

Command Format 

CONTINUE 

Characteristics 

The CONTINUE command: 

Places your terminal in user mode. 

Requires core. 

Does not require LOGIN. 

Example 

♦ RUN LOQP ^ Run a program called LOOP in your disk area. 

"C Stop the program. 

"C 

♦ DAYTIME ^ Check the time of day and the date. 
17-JUN--77 11 : 03J 21 

» CQNT ~+J Continue the program. 
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Function 

The COPY command transfers files from one standard device to 
another. The command string can contain one device output 
specification and any number of input specifications. You use 
the equal sign (=) to separate the destination (output) side from 
the source (input) side. This command runs PIP and performs the 
basic PIP function of transferring files. To copy DECtapes or 
magnetic tapes, refer to the command descriptions of DTCOPY and 
MTCOPY. 

Command Format 

COPY dev: file. ext [directory] <nnn> = dev: file. ext [directory] , .. . 

dev: is a physical or logical device name. If you omit a 
device name, the system assumes DSK. 

file. ext is the name of the file(s) to be used in input or 
output. If you omit the output file name, the system 
assumes the input file name. If you transfer many input 
files to one output file, the system combines the files. If 
you transfer many input files to the same number of output 
files, the system keeps the files as separate files. You 
can use the wildcard construction with the COPY command. 

[directory] is the disk area in which either the files are 
to be read or written. If you type this area before the 
file name, the system uses this area as the default for all 
succeeding files. If you omit this argument, your default 
disk area is assumed. You may transfer files to or from 
another disk area only if you have access to that area. 

<nnn> is the protection code to be given to the output 
file(s). If you omit this argument, the system assigns the 
system standard protection code, even if the input file 
already has a non-standard protection code associated with 
it. 

Switches can be passed to PIP in the COPY command string by 
preceding the switch with a slash. When COMPIL interprets the 
command string, it passes the switches on to PIP. 

Characteristics 

The COPY command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, destroying your core image. 

Examples 

♦ COPY YOURS ♦ CBLC20 > 173=MINE * CBL -^ 

The file MINE.CBL from your disk area is transferred to 
[20,17] with the name YOURS. CBL. You must have privileges 
to write in area [20,17]. 
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Function 

The CORE command types out or modifies the amount of core 

assigned to your job. Because programs usually allocate core, 

you generally do not need this command. It is included for 

completeness and is used more frequently in nonswapping systems 
than in swapping systems. 

If your job is locked in core and you issue this command with a 
nonzero argument, it cannot be satisfied. Therefore, the system 
gives you an erroneous return. 

Command Format 

CORE n 

n is a decimal number; this argument is optional. 

If you omit n, the monitor types out the amount of core used 
and does not change the core assignment. 

If n is 0, the low and high segments disappear from the 
virtual addressing space of your job. 

If n is greater than 0, n represents the total number of 
blocks of core to be assigned to your job from this point 
on. 

If n is less than high plus the minimum low segment size, n 
plus the high segment is assumed. 

Core arguments can be specified in units of 1024 words or 
512-word pages when you follow n with the letter K or P, 
respectively. For example, 3P represents three pages or 
1536 words. If you do not specify K or P, K is assumed 
(i.e. , 1024 words) . 

On systems with the KA10 processor, 1024 words is the 

minimum unit of allocation; therefore, all arguments are 

rounded up to the nearest multiple of 1024 words. For 
example, 3P on the KA10 is treated the same as 2K. 

Characteristics 

The CORE command: 

Leaves your terminal in monitor mode. 

Does not operate when a device is currently transmitting 

data. 

Examples 

♦ C ORE 135P ^ 

♦ C ORE 5S6P ^ 

?Virt* mem* assigned 136P (Current limit* 512P Max limit* 51 2P) 
Phws* mem* assigned 136P (Guideline* 512P Max limit* 139P) 
Swap space left* 1118P 

*CQRE^ 

Virt* mem* assigned 136P (Current limit* 512P Max limit* 512P) 
Phws ♦ mem* assigned 136P (Guideline* 512P Max limit* 139P) 
Swap Bf&ce left: 1.1.20P 
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Function 

The CPUNCH command is used to place entries into the card punch 
output queue. This command is equivalent to the following form 
of the QUEUE command: 

QUEUE CDP: jobname=list of input specifications 

Command Format 

CPUNCH jobname=list of input specifications 

jobname is the name of your job being entered into the 
queue. The default is the name of the first file in the 
request. This may not be the name of the first file 
appearing in the command string, if that file does not yet 
exist, because the /NEW switch was used. The equal sign (=) 
can be omitted if the jobname is also omitted. 

input specification is a single file specification or a 
string of file specifications, separated by commas, for the 
disk files being processed. A file specification is in the 
form dev:file.ext [directory]. 

dev: is any disk file structure to which CDPSPL has 
access; the default is DSK:. 

file.ext is a list of the names of the files. The file 
name is optional. If you do not specify a file name, 
the default for the first file name is *, the default 
for the subsequent files is the last file name used. 
You can omit the extension; its default is .CDP. 

[directory] is a directory to which you have access. 
If you do not specify a directory; your directory area 
is assumed. 

You can obtain the listing of entries in the card punch output 
queue for a specific project-programmer number by following the 
command with the desired project-programmer number enclosed in 
square brackets (e.g., CPUNCH [40,200]). If all arguments to the 
command are omitted (only the command name is specified) , the 
listing of all entries in the card punch queue for all jobs of 
all users is output. 

The wildcard construction can be used for the input 
specifications. Switches that aid in constructing the queue 
entry can also appear as part of the input specifications. These 
switches are divided into three categories: 

1. Queue operation - Only one of these switches can be placed in 
the command string because this category defines the type of 
queue request. The switch used can appear anywhere in the 
command string. 

2. General - Each switch in this category can appear only once 
in the command string because the category affects the entire 
request. The switch used can appear anywhere in the command 
string. 
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3. File control - Any number of these switches can appear in the 
command string because this category is specific to 
individual files within the request. The switch used must be 
adjacent to the file to which it applies. If the switch 
precedes the file name, it becomes the default for subsequent 
files. For example, the command string 

CPUNCH FILEA, FILEB/DISP: REN,FILC 

indicates that the DISPOSE switch is only for FILEB. The 
command string: 

CPUNCH/DISP:REN FILEA, FILEB ,FILEC 

indicates that the DISPOSE switch applies to all three files. 

Note that if you omit the argument to a switch, you must also 
omit the colon preceding the argument. Otherwise, the argument 
is assumed to be zero and not the default value. (Refer to the 
QUEUE command description for a complete list of the switches and 
explanations of their functions.) 

Characteristics 

The CPUNCH command: 

Leaves your terminal in monitor mode. 

Runs the QUEUE program, destroying your core area. 

Does not require LOGIN when only queue listings are desired. 

Examples 

♦ C P U N C H S Y S T A T * M A C / P U N C H t A S C 1 1 «J 

Punch the file SYSTAT.MAC in ASCII format.' 

* CP UNCH SYSTAT . REL/ PUNCH I BINARY/AFTER X 17 1 00 ^7 

Punch the file SYSTAT. REL in binary format, but do not begin 
punching it until after 5:00 p.m. 
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Function 

The CREATE command runs LINED (Line Editor for disk) and opens a 
new file on disk for creation. (Refer to the LINED writeup in 
the DECsystem-10 Software Notebooks . ) 

Command Format 

CREATE file.ext 

file.ext is any legal file name and file name extension. 
The file name is required; the file name extension is 
optional. 

Characteristics 

The CREATE command: 

Places your terminal in user mode. 

Runs the LINED program, destroying your core image. 

Examples 

♦ CREATE TEST.FQR ^ 

* 
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Function 

The CREDIR program is used to create directories and 
sub-directories. It will construct sub-file directories (SFDs) 
on all structures selected, including any higher level 
directories that may be necessary. 

When CREDIR is running on [1,2], it creates UFDs on any selected 
structure or set of structures. You specify the quotas to be 
associated with these UFDs by using appropriate switches or by 
answering questions during the CREDIR dialogue. 

CREDIR can be used for creating ersatz device directories. It 
allows you to create directories on all structures associated 
with a specified ersatz device. As each directory is created, 
CREDIR informs you of the name of the unit and the protection 
code associated with the directory. 

Command Format 

R CREDIR 

CREDIR types out CREATE DIRECTORY:, after which you respond 
with the device name and the directory specification, you 
can specify an ersatz device name and you can supply 
switches in the argument. Device DSK: is assumed if you do 
not specify a device. If you do not specify a protection 
code for the directory, the system gives the directory a 
default protection code of 775. 

Example 

♦ R C REDIR V 

CREATE DIRECTORY: DSKB?C>>ArB>C3 ^ 

CREATED DSKB : l."27 9 4072 9 All . SFD/PR0TECTI0N t 775 
CREATED DSKB : 127 t 4072 9 A t B3 ♦ SFD/F-'ROTECTION : 775 
CREATED DSKB J C 27 9 4072 1 A r B t C 3 ♦ SFD/PROTECT ION J 775 

CREATE DI RECTORY : "C 
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Function 

The CREF command runs the CREF program. In doing so, it lists on 
the line printer any cross-referenced listing files that were 
generated since your job was initiated. You generate 
cross-referenced files by using the /CREF switch in any previous 
COMPILE, LOAD, EXECUTE or DEBUG commands. The file containing 
the names of these CREF-listing files is then deleted so that 
subsequent CREF commands will not list them again. The output 
goes either to LPT immediately or to the disk to be spooled later 
to LPT. When the logical device name LPT is assigned to a device 
other than the line printer, the CREF files are stored on that 
device with the same file name and the extension .LST. (Refer to 
the CREF manual in the DECsystem-10 Software Notebooks for more 
information. ) 

Command Format 

CREF and CREF file-specification 

where file-specification is device: filename. extension [ppn] . when 
you supply a file specification in the command line, cref 
produces a crossOreferenced listing file for the specfied file. 

Characteristics 

The CREF command: 

Leaves your terminal in monitor mode. 

Runs the CREF program, destroying your core image. 

Example 

♦ COMPILE /CREF(?PROMAC ^ Compile the files contained in the 

command file PROMAC and produce CREF 

input compatible cross-referenced 

listing files on the disk. 

Process and list the cross-referenced 
listing files produced by the COMPILE 
command. 



♦ CREF^ 



LQAD/C/MAPiNAME eCPNALL ^ Compile and load the files contained 

in the command file CONALL. Produce a 
loader map with the file name NAME and 
CREF input compatible cross-referenced 
listing files on the disk. 



♦ ASSIGN MTAl LPT *J 
ASSIGNED TO JOB 

♦ CREF +J 



Assign the logical name LPT to MTAl. 

Store the CREF files on MTAl to be 
listed at a later time. 
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Function 

The CSTART and CCONTINUE commands are identical to the START and 
CONTINUE commands, respectively, except that your terminal is 
left in monitor mode. 

Command Format 

CSTART addr 
CCONTINUE 

addr is the address at which execution is to begin if other 
than the location specified within the file (.JBSA). If 
addr is not specified, the starting address comes from .JBSA 
(stored in the job data area) . An explicit starting address 
of may be specified for addr. 

To use: 

1. Begin the program with your terminal in user mode. 

2. Type control information to the program, then Type a 
CTRL/C to halt your job with your terminal in monitor 
mode. 

3. Type CCONTINUE to allow your job to continue running and 
leave your terminal in monitor mode. 

4. You can now enter additional commands from your 
terminal. 

Characteristics 

The CSTART and CCONTINUE commands: 

Leave your terminal in monitor mode. 
Require core. 

Restrictions 

The commands should not be used when your program (which 
continues to run) is also requesting input from the terminal. 
These commands are not available to batch users. 
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CCONTINUE Command 

Example 

. TYPE TEST*ALG ^ 

BEGIN INTEGER SrC»B»A 

'THIS PROGRAM WILL ADD THREE NUMBERS AND? 

! PRINT THE RESULT? 

WRITE ("L2C3 WHAT ARE THE NUMBERS TO ADD C1C3 " > ? 

READ <S>? 

READ <C>? 

READ <B)J 

A:*C+S+D5 

WRITE ("C2C3 THE SUM OF ")» 

PRINT (S»3>3>f 

WRITE (" AND ")» 

PRINT <C»3»3>» 

WRITE <" AND ")? 

PRINT <B*3*3>? 

WRITE (■ IS ">? 

PRINT <A»3»3»>» 

WRITE ("C2C3 ")? 

END 

♦ EXECUTE TEST . ALG ^ 
ALGOL J TEST 

LINK J LOADING 

LLNKXCT TEST EXECUTIONS 

WHAT ARE THE NUMBERS TO ADD 
23 45 ~J 

2£ 

♦ CCQNT *J 

♦TIME^y 

7*50 

7 ♦ 50 

K I L0-C0RE-SEC--64 

♦ SYSTAT ^ 

?PLEASE TYPE CONTROL-C FIRST 

♦ TIME ^ 
0*00 
7*50 
KIL0-C0RE-SEC«A4 

♦ T 
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Function 

The D command deposits information in your core area (high or low 
segment). When debugging a sharable program with the D command, 
the SAVE command should be used rather than the SSAVE command. 

When running under a virtual memory system, DAEMON is called if 
on a D command, the page in question is paged out. 

Command Format 

D lh rh addr 

lh is the octal value to be deposited in the left half of 
the location. This argument is required. 

rh is the octal value to be desposited in the right half of 
the location. This argument is required. 

addr is the address of the location into which the 
information is to be deposited. This argument is optional. 

If you omit addr, the system deposits the data into the 
location following the last D addr command or in the 
location of the last E addr command (whichever was last) . 

Characteristics 

The D command: 

Leaves your terminal in monitor mode. 
Requires core. 



Example 

. D 266000 2616 lAl ^J 

» E 14 0^7 

000.1.40/ 265720 40011 .D 47000 l«J 



Deposit in location 141. 

Examine location 140 

Because addr is omitted, 
the deposit is in the 
location of the last E 
command. 



000140/ 047000 000001 



Examine is location 
specified in the previous 
D command. 
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Function 

The DAYTIME command types the date followed by the time of day. 
The date and time are typed in the following format: 

dd-mmm-yy hh:mm:ss 

where: dd = day 

mmm = month 

yy = year 

hh = hours 

mm = minutes 

ss = seconds to the nearest hundredth 

Command Format 

DAYTIME 

Characteristics 

The DAYTIME command 

Leaves your terminal in monitor mode. 

Does not require LOGIN. 

Does not destroy your core area. 

Examples 

♦ DAYTIME^ 

28 -Jul -77 15 J 08 J 12 

28- Jul -77 15: 08 J 19 
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Function 

The DCORE command causes the DAEMON program to write a core-image 
file of your core area that includes all accumulators and all 
relevant job tables. The job can contine to run; the DCORE 
command does not destroy your core image. The file produced may 
be processed later by the DUMP program, if you wish. 

The DAEMON-written file consists of five categories: JOB, 
CONFIGURATION, DDB, CORE, and FEATURES. Each category has a 
2-word header, the first word contains the category number and 
the second word contains the number of data words in the 
category. The categories are listed below. 



Mnemonic 
JOB 



Category Number 
1 



Description 
Job-related information, 



CONFIGURATION 



TheConf iguration Table 
(.GTCNF) from the GETTAB 
monitor call. 



DDB 



CORE 



FEATURES 



The device data blocks (DDB) 
assigned to this job. 

Your core area, both the low 
and the high segments, in 
zero-compressed format. 

The Feature Table (.GTFET) 
from the GETTAB monitor 
call. 



The third word of each category begins the data from that 
category. The DAEMON-written file is shown in Figure 2-1. 
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36 words 



category number 1 
number of words that follow 

job-related information 

category number 2 
number of words that follow 



25 words 



.GTCNF table 



N words 



N words 



N words 



category number 3 
number of words that follow 

n(l) 1 N = n(l) + n(2) + ...+n(m) 

J n(l) words of DDB(l) 

n(2) 
. n(2) words of DDB(2) ) Device Data Blocks 



n(m) 

♦ n(m) words of DDB(rn)" 

category number 5 
number of words that follow 

.GTFET table 

category number 4 
number of words that follow 



user's core in zero-compressed format 



Figure 2-1 DAEMON-written File 
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Categories may be written in any order. Version 7 of DAEMON 
writes the categories in the following order: 1, 2, 3, 5, 4, but 
programs should not assume any special order. 

Category 1 presently contains the following information, but may 
expand as more GETTAB entries appear. 

Category 2 contains the entries in the .GTCNF GETTAB table. 
(Refer to the UUOSYM listing in DECsystem-10 Monitor Calls .) 

Category 3 contains the device data blocks currently in use for 
this job. Each DDB is preceded by a word containing the length 
of the DDB. 

Category 4 is a compressed core image of both the high and low 
segments. It contains only nonzero words. 

Category 5 lists the feature test switches as obtained from the 
GETTAB Table .GTFET. 

Command Format 

DCORE dev: name. ext [directory] 

dev: is a disklike device on which the core image file is 
to be written. If you omit this argument, the system 
assumes DSK. 

name. ext is the name of the file to be written. The default 
file name is nnnDAE, where nnn is your job number in 
decimal, and the default extension is .TMP. If you supply 
the file name, the default file name extension is .DAE. 

[directory] is the disk area other than your directory area. 
If you omit this argument, the system assumes that your disk 
area is to be used. 

Characteristics 

The DCORE command: 

Leaves your terminal in monitor mode. 

Runs the DAEMON program, destroying your core area. 

Can be continued after command. 



Examples 

.DCQRE^ 



♦ DCORE DSKBJFILEC^ 



The core image is written on your area of 
the disk with the name nnnDAE. TMP, where 
nnn is your job number. 

The core image file is written in your area 
on DSKB with the name FILEC.DAE. 
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Function 

The DDT command copies the saved program counter value from .JBPC 
into .JBOPC and starts the program at an alternate entry point 
specified in .JBDDT (beginning address of DDT as set by LINK-10). 
DDT contains command to allow you to start or resume at any 
desired address. (Refer to DECsystem-10 Monitor Calls for a 
description of the above mentioned Job Data Area locations.) 



If your job was executing a monitor call when interrupted (in 
exec mode and not in TTY input wait or SLEEP mode) , the monitor 
sets a status bit (UTRP) and continues the job at the location at 
which it was interrupted. When the monitor call processing is 
complete, the monitor clears the status bit, sets .JBOPC to the 
address following the monitor call, and then traps to the DDT 
address found in .JBDDT. If your job is in exec mode and in TTY 
INPUT WAIT or SLEEP MODE, the trap to the DDT address occurs 
immediately and .JBOPC contains the address of the monitor call. 
If your job is in user mode, the trap also occurs immediately. 
Therefore, it is always possible to continue the interrupted 
program after trapping to DDT by executing a JRSTF @ .JBOPC. 



(For addtional information on the 
Programmer's Reference Manual. ) 



DDT program, refer to DDT 



Command Format 
DDT 

Characteristics 

The DDT command: 



Places your terminal in user mode. 

Requires core. 

Requires that you have a job number. 

If the system is configured with the virtual memory option 

and .JBDDT is zero, the system will read in SYS:DDT.VMX 

starting at location 700000. 



Examples 

♦ TYPE LOOP* MAC ^ 
LOOPJJRST LOOP 
END LOOP 



Type an undebugged program. 



2Z 

♦ OS AVE *J 
JOB SAVED 



Save the program. 



♦ DDT^ 



Enter DDT. 



LOOP/JRST LOOP CALLI 12 Fix the program. 
JRSTF 6 . JBOPC0X 

EXIT 
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Function 

The DEASSIGN command returns one or more devices currently 
ASSIGNed to your job back to the monitor's pool of available 
devices, and clears any logical names. Restricted devices are 
returned to the restricted pool, and unrestricted devices are 
returned to the unrestricted pool. An INITed device is not 
returned to the monitor's pool unless you have issued a RELEASE 
monitor call, only the logical name is cleared. This command is 
provided for programs that are not terminating or programs that 
are being debugged. The command, applied to DECtapes, clears the 
copy of the directory currently in core, forcing the next 
directory reference to read a new copy form the tape . (Refer to 
DECsystem-10 Monitor Calls for further details.) 

Command Format 

DEASSIGN dev 

dev is either the logical or the physical device name. This 
argument is optional. If you do not specify this argument, 
the system deassigns all devices from your job, except your 
job's controlling terminal. Also, the system clears the 
logical name associated with the controlling terminal. 

Characteristics 

The DEASSIGN command: 

Leaves your terminal in monitor mode. 
Examples 

♦ D E ASSIGN L P T ^J The line printer is returned to the monitor's 

pool of available resources. 

♦ DEASSIGN ^J All devices assigned to your job are returned 

to the monitor's pool of available devices. 
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Function 

The DEBUG command translates the specified source files, if 
necessary (function of the COMPILE command) , loads the REL files 
generated (function of the LOAD command), and prepares for 
debugging. A system debugging program is loaded first, followed 
by your program with local symbols. Upon completion of loading, 
control is transferred to the debugging program. The debugging 
program used depends on the first file in the command string. If 
this file is a COBOL source file, COBDDT (the COBOL debugging 
program) is used. If the first file is a file other than a COBOL 
SOURCE file, DDT (the Dynamic Debugging Technique) is loaded. 

NOTE 

This command runs the COMPIL program, which interprets 
the command before running the appropriate language 
translator, the LINK-10, and the appropriate debugger. 

When the first file is a previously translated program (i.e., 

with extension .REL) and COBDDT is desired as the debugging 

program, the /COBOL switch must appear in the command string. 
For example: 

.DEBUG FILEA.REL/COBOL 

(Refer to DDT documentation for a description of DDT commands, 
and refer to COBOL documentation for a description of COBDDT.) 

Generally, the use of the DEBUG command requires more core to 
execute a program than the EXECUTE command requires. Extra space 
is occupied by the system debugging program and additional 
debugging information, such as local symbols. 

Each time a COMPILE, LOAD, EXECUTE, or DEBUG command is executed, 
the command with its arguments is remembered in a temporary file 
on disk, or in core if the monitor has the TMPCOR feature. 
Issuing one of these command, without its arguments, causes the 
arguments saved in the temporary file to be reused. (Refer to 
Section 1.5). 

The DEBUG command accepts several command constructions: the @ 
construction (indirect commands), the + construction, the = 
construction, and the < > construction. (Refer to Section 1.5 
for a complete description of each of these constructions.) 

Command Format 

DEBUG list 

list is a single file specification or a string of file 
specifications, separated by commas. A file specifications 
consists of a device name, a file name (with or without an 
extension), and a directory name. Refer to Section 1.4.2.4. 

The following switches can be used to modify to command string. 
These switches are temporary or permanent unless stated 
otherwise. 
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Switch 
/ALGOL 

/BIN 



/BLISS 



Meaning 

Compile the file with ALGOL, 
with the extension of .ALG. 



Assumed for files 



Generate a binary file for each file compiled. 
The file name of the binary file follows the 
standard conventions for determining the file name 
of the output file; refer to Sections 1.5.2 and 
1.5.3. The extension is .REL. This is the 
default action. 



Compile the file with BLIS10. Assumed 
with the extension of .BIO and .BLI. 



for files 



NOTE 

BLIS1U is recognized as a translator only 
if the appropriate switch is set. 
However, this assembly switch setting is 
not supported. 



/COBOL 
/COMPILE 



/CREF 



/DDT 

/FOROTS 

/FORSE 

/FORTRAN 



Compile this file with COBOL, 
with the extension of .CBL. 



Assumed for files 



Force a compilation on this file even if a binary 
file exists with a newer date and time than the 
source file. This switch is used to obtain an 
extra compilation (in order to obtain a listing of 
the compilation) , since normally compilation is 
not performed if the binary file is newer than the 
source file. 

Produce a cross-reference listing file on the disk 
for each file compiled for later processing by the 
CREF program. The file name for the listing file 
follows the standard convention for determining 
the name of the output file; refer to sections 
1.5.2. and 1.5.3. The extension is .CRF. The 
file can then be listed with the CREF command. 
However, with COBOL files, the cross-referenced 
listing is always appended to the listing file. 
No additional command need be given to obtain the 
listing. 

Load DDT regardless of the extension of the first 
file in the command string. This is a permanent 
switch and applies to all subsequent files. 



Load the file with FOROTS, 
object-time system. 



the new 



Load the file with /FORSE, the old 
object-time system. 



FORTRAN 



FORTRAN 



Compile the file with a FORTRAN compiler. Assumed 
for files with the extension .F4 amd .FOR and all 
files with nonrecognizable translator extensions, 
if FORTRAN is the standard translator. This 
switch is needed if the file has a nonrecognizable 
translator extension and FORTRAN is not the 
standard translator or is not the current default. 
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Switch 
/FUDGE 



/FlO 



/F40 



/K?10 



/LIBRARY 



/LINK 



Meaning 

Create a disk file containing the names of the 
.REL files produced by the command string. When 
the FUDGE command is given, PIP reads this file in 
order to generate a library REL file (refer to the 
FUDGE2 program description) . Arguments to this 
switch are: 

/FUDGE :dev: f ile.ext [project, programmer ] 

dev: is the device on which to write the 
file. If you omit this argument, the system 
assumes DSK. 

file.ext is the name of the library file. 
The file name is required. If you omit the 
file name extension, the system assumes .REL. 

[project, programmer ] is the directory area in 
which the system is to place the file. If 
you do not supply this argument, the system 
assumes your directory area. 

This switch is a permanent switch so far as 
it pertains to all REL files generated by the 
command string. 

Use the FORTRAN-10 compiler when compiling the 
associated FORTRAN file. This should be used as a 
permanent switch because it is not possible to 
load F40 and FORTRAN-10 binary files together. 

Use the F40 compiler when compiling the associated 
FORTRAN file. This switch should be used as a 
permanent switch, because it is not possible to 
load F40 and FORTRAN-10 binary files together. 

Designate the machine on which the program will 
execute once it has been loaded. These switches 
are needed for FORTRAN-10 programs because the 
compiler generates different codes for the 
processors. The default is the processor on which 
your program is running. The ? can be A, I, or 
L. 

Load the files in library search mode. This mode 
causes a program file in a special library to be 
loaded only if one or more of its declared entry 
symbols satisfies an undefined global request in 
the source file. The system libraries are always 
searched. (Refer to LINK-10 documentation.) 

Cause the file to be loaded by the LINK-10 linking 
loader. If used, this switch should be placed 
before any file specifications since the COMPIL 
program may have to generate load-control 
switches. This is the current default action. 
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Switch 
/LIST 



/LMAP 

/LOADER 
/MACRO 

/MACY11 

/MANTIS 

/MAP 



/NEW 



/NOBIN 



/NOCOMPILE 



Meaning 

Generate a disk listing file for each file 
compiled. The file name for the listing file 
follows the standard conventions for determining 
the name of the output file. (Refer to Sections 
1.5.2 and 1.5.3.) The extension is .LST. These 
files can be listed later with the LIST command. 
If the line printer is being spooled for this job, 
the listing files are written on device LPT and 
are automatically spooled at LOGOUT time. Unless 
this switch is specified, listing files are not 
generated. 

Produce a loader map during the loading process 
(same action as /MAP) containing the local 
symbols. 

Cause the file to be loaded by the LOADER program. 

Assemble the file with MACRO. Assumed for files 
with the .MAC extension. 



Assemble the file with MACYll. 
with the .Pll extension. 



Assumed for files 



Compile the 
information, 
only. 



file with the MANTIS debugging 
This switch affects F40 programs 



Produce a loader map during the loading process. 
When this switch is encountered, the system 
requests a loader map from the loader. After the 
library search of the system libraries, the system 
writes the map in your disk area with either the 
file name you specified or the default file name 
MAP. MAP, if loading is performed by LOADER, or 
nnnLNK.MAP, if performed by LINK-10. This switch 
is an exception to the permanent switch rule 
because it causes only one map to be produced, 
even though it may appear as a permanent switch. 

Run the appropriate language translator from the 
experimental system library (device NEW:) area 
[1,5]. If the translator does not exist on device 
NEW:, try to obtain it from device SYS:. 

Do not generate binary files. Unless this switch 
is given, binary files are generated. This 
switch, when combined with the /LIST or /CREF 
switch is useful when compiling programs solely 
for the purpose of generating listing. 

Complement of the /COMPILE switch by not forcing a 
compilation on a source file whose date is not as 
recent as the date on the binary file. Note that 
this switch is not the same as the /REL switch, 
which turns off all compilation, even if the 
source file is newer than the REL file. 
/NOCOMPILE is the default action. 



/NOLI ST 



Do not generate 
default action. 



listing files. This is the 
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Switch 
/NOMANTIS 

/NOSEARCH 



/OLD 



/REL 

/SEARCH 

/SELF 



/SNOBOL 
/SYS 



Meaning 

Compile the file without the MANTIS debugging 
information. This switch affects F40 programs 
only. 

Loads all routines of the file whether the 
routines are referenced or not. Because this is 
the default action, this switch is used only to 
turn off library search mode (/LIBRARY) . This 
switch is not the equivalent of the /P switch of 
the LOADER, which does not seach any libraries. 
The /NOSEARCH default is to search the system 
libraries. 

Run the appropriate language translator from the 
system library of old programs (device OLD:), 
which resides on the disk area [1,3]. If the 
translator does not exist on device OLD:, try to 
obtain it from device SYS:. 

Use the existing REL files although newer source 
files may be present. 

The action is identical to that of the /LIBRARY 
switch. 

Run the appropriate language translator from 
device DSK: instead of from the system library 
(device SYS:). This switch is useful for an 
individual who keeps a private copy of a 
translator in his own disk area. System 
programmers occasionally keep experimental 
versions of standard translators in their disk 
area in order to test new features. 

Compile the file with SNOBOL. Assumed for files 
with the .SNO extension. 



Run the appropriate processor from 
library (device SYS:) area of [1,4]. 
default action. 



the system 
This is the 



NOTE 

A processor appearing more than once 
within a single command string cannot 
specify more than one disk area. For 
example, the following is illegal: 

. DEBUG MAIN . MAC /SELF , PARTI . MAC /OLD 

However, the following is valid. 

.COMPILE MAIN. MAC /SELF 
.COMPIL PARTI. MAC /OLD 
.DEBUG /REL MAIN, PARTI 
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Characteristics 

The DEBUG command: 

Places your terminal in user mode. 

Runs the appropriate processor, LINK-10, and the debugger, 

destroying your core image. 

Examples 

♦ DEBUG/L FILEA» FILES yFILEC/N^FILED ^ 

Generate listings for files FILEA, FILEB, and FILED. 

♦ DEBUG TEST ^y 
MACRO J TEST 
LOAD I NO 

LOADED 2K CORE 
DDT EXECUTION 

./ BLT 15 y Of 16 3 



2-45 



DELETE Command 



Function 

The DELETE command deletes one or more files from disk or 
DECtape. The protection codes normally assigned to files prevent 
one user from deleting files in another user's directory. 

Command Format 

DELETE list 

list is a single file specification or a string of file 

specifications, separated by commas. The full wildcard 

construction (* and ?) can be used. (Refer to Section 
1.4.2.4. ) 

If you do not specify a device name or a file structure 
name, it remains in effect until you change it or until the 
system reaches the end of the current command string. When 
you specify a directory name before a file name, the 
directory becomes the default for all succeeding files. A 
directory name after a file name applies only to that file. 

Characteristics 

The DELETE command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, destroying your core image. 

Examples 

* DELETE TEST.ALG ^ 
Files deleted* 
TEST.ALO 

♦ DELETE FROG !♦ FOR ^ 
Files deleted* 
PROG 1* FOR 

♦ DELETE FRQG.REL^ 
Files deleted* 
PRQG.REL 
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Function 

The DETACH command disconnects the terminal from your job without 
affecting the status of the job. Your terminal is now freed for 
another job, to either start a new job or attach to a currently 
running detached job. 

An operator can DETACH any device, (except a spooled device.) 
(See Appendix A of the Operator's Guide . ) 

Command Formats 

1. DETACH 

2. DETACH dev: (This format is operator privileged.) 

Characteristics 

The DETACH command: 

Detaches the terminal. 

Restrictions 

This command is not available to batch users. 

Example 

> DETAC H^ 
From Job 30 
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Function 

The DIRECT command lists the directory entries specified by the 
argument list. The standard output consists of the following 
columns: file name, file name extension, length in blocks 
written, protection, creation date, version number, structure 
name, and directory name. Refer to the DIRECT specification in 
the DECsystem-10 Software Notebooks for additional information on 
the DIRECT program. 

Command Format 

DIRECT output specification = list of input specifications 

list = A single file specification, or a string of file 
specifications separated by commas or plus signs. The devices 
used on input can be DSK:, DTA: , MTA:, and TMP: (TMPCOR) . If 
the device is a magnetic tape, the tape is rewound before and 
after the listing operation and analyzed to determine if it is a 
FAILSAFE or BACKUP tape. The default input specification is 
DSK:*.*, and your directories in all file structures defined by 
the job's search list are listed. Generally, a device name, an 
extension, or a directory name that precedes the file name 
becomes the default for all succeeding files in the list. 

The full wildcard construction (* and/or ?) can be used on input 
specifications. When a wildcard designation is used, the DIRECT 
program limits its search for the file to certain directories. 
When you give a wildcard designation for a file name or 
extension, the program only searches the specified directory or 
your default directory. No additional directories, such as LIB 
or SYS, which may be in your default path are searched. (Refer 
to the SETSRC program description, in this manual, and to the 
PATH. Call description in DECsystem-10 Monitor Calls .) If you 
have a wildcard designation for a directory, only the directories 
implied by the wildcard construction are searched. Again, no 
additional directories are searched. When you give a file 
specification without any wildcard designations, the DIRECT 
program uses the normal procedures for locating the file. That 
is, your path, LIB, NEW, and SYS are enabled by you via the 
SETSRC program or the PATH. Call are searched. 

output specification = This argument (and the equal sign) is 
optional. If the entire output specification is omitted, the 
default is TTY: . If an output file name is given, the default 
device is DSK:. If an output file name is not given, and one is 
needed, the file name is generated from the time of day as 
hhmmss. The default output extension is .DIR. The wildcard 
construction cannot be used in the output specification. 

The following switches may be used in the command string. 
Generally, non-complementary switches can be used together in the 
same command string. Switches that precede the file name become 
the default for all succeeding files. 

You can truncate switches as long as the resulting abbreviation 
is unique. Spaces are not permitted with a switch, between the 
slash at the beginning of the switch and the argument at the end. 
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Switch 
/ACCESS :n 



/ALLOC 



/AUTHOR 

/BEFORE: date: time 

/BLOCKS 

/CHECKSUM 

/DENSITY: n 



/DETAIL 



Meaning 

Update the access date to the current date 
for any file of n blocks or less accessed, 
listed, by the DIRECT program. Because some 
installations delete files that have not been 
recently accessed, this switch allows you to 
prevent such deletion by updating the date, 
n is interpreted as a decimal number, and 
refers to the number of blocks actually 
written in the file unless the /ALLOC switch 
is also used. If you omit the /ACCESS 
switch, the system does not change the date. 
If you specify /ACCESS but you omit :n, n = 5 
is assumed. 

List the allocated length of the file instead 
of the written length. Space on a structure 
is sometimes allocated in units of more than 
one block for efficiency. Therefore, the 
number of blocks allocated to a file may be 
greater than the number of blocks actually 
written. The LOGOUT program uses the 
allocated length when checking quotas. The 
total allocated length of all files is the 
same as the length output by the QUOLST 
program under the USED column. This switch 
is the complement of the /WRITTEN switch. 



Output the project-programmer number of 
author of the file. 



the 



List only those files created before the 
specified date and time. Default is 
+infinity. Refer to Section 1.4.2.5. 

Output the length of the file in blocks 
instead of words. Complement of /WORDS. 
This is the default. 

Compute and print an 18-bit checksum for each 
file. This checksum is computed by rotating 
the result left one bit before adding each 
word. Complement of /NOCHECKSUM. 

Use the specified density when reading a 
magnetic tape. n is 200, 556, 800, 1600, or 
6250 bpi. The default is 
installation-dependent and is modified by the 
SET DENSITY command. 



Print 

except 

LOOKUP 

for a 

The pr 

even 

listed 

direct 

decima 

octal. 



all avai 

for zer 

block i 

list o 

otection 

if they 

if it i 

ory . N 

1 numbe 

magnet 



lable information about a file 
o values (refer to the extended 
n DECsystem-10 Monitor Calls 



f the values that are printed) . 
and data mode are also listed, 
are zero. The author is not 
s the same as the owner of the 
umbers followed by a period are 
rs. All other numbers are 
ic tape only. ) 
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Switch 
/EOTS 

/FAST 

/FDTA 
/FILES :n 



/HELP 
/HELP:S 

/INDIRECT 

/LIST 

/MARKS 

/NOAUTHOR 

/NOCHECKSUM 

/NODETAIL 
/NOEOTS 

/NOFDTA 
/NOMARKS 

/NOPRDEVICE 



Meaning 

Stop at the logical end of tape (two 
consecutive tape marks) when reading a 
magnetic tape. Complement of /NOEOTS. This 
is the default. 

List short form of directory: file name, 
extension, structure name, and directory 
name. Equivalent to /F. Complement of 
/NORMAL and /SLOW. 

Get the DTA directory from core. 

Stop after n tape marks (files) when reading 
a magnetic tape. If you specify /FILES but 
you omit :n, n = is assumed. Note that the 
logical EOT will also stop the tape unless 
/NOEOTS is specified. 

Type the help text that indicates some of the 
switches available and how to use them. 
Equivalent to /H. 

List all switches (S) without their 

explanations. An asterisk prefixes those 

switches that have a single-letter 
abbreviation. 

Make a CCL file that allows you to sort on 
directories or files. 

List the output on device LPT: . Equivalent 
to /L. 

Indicate each tape mark, including the final 
tape mark, and UFD when reading a magnetic 
tape. Complement of /NOMARKS. 

Do not output the PPN of the author of the 
file. This is the default. Complement of 
/AUTHOR. 

Do not compute and print the checksum. 
Complement of /CHECKSUM. This is the 
default. 

Do not list the words in the LOOKUP block. 
Complement of /DETAIL. This is the default. 

Do not stop at the logical end of tape when 
reading a magnetic tape. Complement of 
/EOTS. 

Do not get the DTA directory from core. This 
is the default. Complement of /FDTA. 

Do not indicate each tape mark and UFD when 
reading a magnetic tape. Complement of 
/MARKS. This is the default. 

Do not print the device name. Complement of 
/PRDEVICE. 



2-50 



DIRECT Command (Cont.) 



Switch 

/NOPRD I RECTORY 

/NORMAL 



Meaning 

Do not print the directory. 
/PRD I RECTORY. 



Complement of 



/NOREWINDS 

/NOSORT 
/NOSUMMARY 

/NOTITLES 

/NOUNITS 

/OKNQNE 
/OPTION: name 



/PARITY: ODD 
/PARITY: EVEN 

/PHYSICAL 



/PRDEVICE 
/PRD I RECTORY 



Output the normal directory listing. This 
listing includes the file name, extension, 
length in blocks written, protection, 
creation date, structure name, non-zero 
version numbers, and directory name. 
Complement of /FAST and /SLOW. This is the 
default. The switch is used to override a 
/FAST or /SLOW in your option file. 

Do not rewind the tape before and after 
reading a magnetic tape. Complement of 
/REWINDS. 

Do not produce a file suitable for sorting. 
Complement of /SORT. This is the default. 

Do not use summary mode and output more than 
just the summary line. Complement of 
/SUMMARY. This is the default. 

Do not output page headers. Complement of 
/TITLES. This is the default for output to 
the terminal. 

Do not list the name of the actual disk unit; 
instead, just list the structure name. 
Complement of /UNITS. This is the default. 

Suppress the error message if no files match 
the wildcard construction. 

Read your option file (DSK: SWITCH. INI) to 
determine your specified switch defaults for 
DIRECT. The name appearing as the value of 
the switch is the pointer to the line to read 
in the file. For example, if the file 
contains the line 

DIRECT : ALL/DETAI L 

then you reference this line by typing the 
command 

DIRECT/OPTION: ALL 

Refer to Section 1.4.3 for additional 
information. 

Specify the parity to be used when reading a 
magnetic tape. The default is ODD. 

Ignore logical names used for device names 
(refer to the ASSIGN command for a 
description of logical names). 

Print the device. 

Print the directory. 
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Switch 
/PROTECTION :nnn 

/REWINDS 

/RUN: file spec 
/RUNOFFSET:n 

/SINCE: date: time 
/SLOW 



/SORT 



/SUMMARY 



/TITLES 



/UNITS 



/WIDTH :n 



Give 
(octal 



Meaning 
the output file the protection nnn 



Rewind the magnetic tape before and after 
reading it. Complement of /NOREWINDS. This 
is the default. 



Run the specified program when this 
is finished. 



command 



Run the program specified with /RUN with an 
offset of n. If the switch is omitted, the 
default is 0; if the switch is given without 
a value, the default is 1. 

List only those files created after the 
specified date and time. The default is 
January 1, 1964. Refer to Section 1.4.2.5. 

Output a full listing that includes the file 
name, extension, length in blocks written, 
protection, creation date and time, access 
date, structure name, and directory name. 
Equivalent to /S. Complement of /FAST and 
/NORMAL. (Disk and magnetic tape only.) 



List the file str 
more than one or 
tape, and direc 
directory is gi 
only on the first 
Multiple spaces 
Project-programme 
zeros; the date 
for Oct 9, 1972. 
prepare a file 
program (refer 
Programmer's Ref 



ucture name, if there is 
if the files are on magnetic 
tory name, if a wildcard 
ven, on each line instead of 

line in which they change. 

are output instead of TABs. 

r numbers include leading 

is in ANSI format: 19721009 

This switch is used to 

to be sorted by the SORT 
to the DECsystem-10 COBOL 
erence Manual ) . Complement 



of /NOSORT. 

Output only the summary line that indicates 
the total number of blocks and files. Note a 
/FAST/SUMMARY lists a /FAST listing followed 
by the summary. 

Cause a heading to be output on each page 
consisting of a label for each column, date, 
time, and page number. Standard output to 
the line printer has this heading. 
Complement of /NOTITLES. 

List the name of the actual disk unit on 
which the files are stored instead of the 
file structure name. Complement of /NOUNITS. 

Output several entries on a single line to 
make the output n columns wide. If /FAST is 
specified for output to a terminal, four file 
names appear per line. The default for n is 
64 columns. 
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Switch 
/WORDS 

/WRITTEN 



Characteristics 

The DIRECT command: 



Meaning 

Output the length of the file in words 
instead of blocks. Complement of /BLOCKS. 

Return the written length of the file rather 
than the allocated length. Complement of 
/ALLOC. This is the default. 



Leaves the terminal in monitor mode. 

Runs the DIRECT program, thereby destroying your core image. 



Examples 

♦ DIR DTA003i ^ 



Lists all files on DTA3. 

Lists all files with extension .MAC in 
all file structures in the user's job 
search list. 



♦ PIR TEST «F4i:27> 40723 ^ Lists the directory entry for the file 

TEST.F4 in user area 27,4072. 



The ordinary default directory. 



.DIR^ 



GHOST 

1 

COMMAN 


EXE 


16 


<055> 


28" Jul -77 


1(5) 


RNO 


1 


<055> 


4-Aus$ -77 




LOGOUT 


MIC 


1 


<055> 


4~Au&~77 




MANUAL 


RNO 


3 


<055> 


4~Au.<3~77 




MICV2 


DOC 


95 


<055> 


4 -A us! "7 7 




PATMON 


RNO 


27 


<055> 


4 ~Au £*•••• 7 7 




PRINT 


MIC 


1 


«)55> 


4-Auj3-77 




TAPES 


RNO 


112 


<055> 


4-AusS-77 




UUOSYM 


RNO 


218 


<055> 


4~Ausi-77 




2050 


RNO 


3 


<055> 


4 -Autf- 77 




C0M2B 


RNO 


127 


<055> 


4~Ausi -77 




C0M2C 


RNO 


105 


<055> 


4~Au<?3~77 




C0M2D 


RNO 


46 


<055> 


4~AusS -77 




TITLE 


RNO 


1 


<055> 


4 - A u <•*••- 7 7 




C0M12 


RNO 


72 


<055> 


4 ~Au <=*■•• 77 




FILDAE 


RNO 


58 


<055> 


4 - A u £{•••• 7 7 




C0M1 


RNO 


98 


<0S5> 


4-Au«$"77 




C 




1 


<055> 


31 -Jul -77 




C0M2A 


RNO 


161 


<055> 


4-AUS--77 




COM 11 


RNO 


132 


<055> 


4-Au.^~77 




C0MM2 


RNO 


841 


<055> 


4-Au<3~-77 




C0IND2 


IND 


12 


<055> 


4--AusJ~77 




SWITCH 


BAK 


1 


<055> 


4-Aui-l -77 




SWITCH 


INI 


1 


<055> 


4--AUSS-77 




HEADS 


BAK 


16 


<055> 


4 -A us! -7 7 




COM3 


MEM 


131 


<055> 


4~-Au<st -77 




COM3 


BAK 


126 


<055> 


4 -Au<-$~77 




COM3 


RNO 


126 


<055> 


4-Aua~77 




TOPS 10 


RNO 


4 


<055> 


4-Au^-77 




Total 


of 2536 


blocks 


in 29 


files on DSKCJ 


C27»51103 



DSKC X 



C 27 » 5 110 
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,1'IR/ttLLOC^J 



♦ 

GHOST 

:j 

COMMAN 


EXE 


20 


<055> 


28- Ju I -77 


RNO 


10 


<055> 


4~Au^™77 


LOGOUT 


MIC 


10 


<055> 


4~Au.<3~77 


MANUAL 


RNO 


10 


<055> 


4~-Au£$-77 


MICV2 


DOC 


100 


<055> 


4-Au«{-77 


PATMON 


RNO 


30 


<055> 


4-Aus*-77 


PRINT 


MIC 


10 


<055> 


4-Aua-77 


TAPES 


RNO 


120 


<055> 


4~Au<=$-77 


UUOSYM 


RNO 


220 


<055> 


4-Aua-77 


2050 


RNO 


10 


<055> 


4- Au si-77 


C0M2B 


RNO 


130 


<055> 


4-Ausl-77 


C0M2C 


RNO 


110 


<055> 


4-AUJ3--77 


C0M2D 


RNO 


50 


<055> 


4~Aua~77 


TITLE 


RNO 


10 


<055> 


4 -Aui=i -77 


C0M12 


RNO 


80 


<055> 


4 ""Aug "7 7 


FILDAE 


RNO 


60 


<055> 


4-Au<3~77 


COM3. 


RNO 


100 


<055> 


4-Aua~77 


C 




10 


<055> 


31-Jul-77 


C0M2A 


RNO 


170 


<055> 


4 ~Ausf- 77 


COMii 


RNO 


140 


<055> 


4-Au<ri- 77 


C0MM2 


RNO 


050 


<055> 


4-AuS--77 


C0IND2 


IND 


20 


<055> 


4-AUS-77 


SWITCH 


BAK 


10 


<055> 


4-AusS--77 


SWITCH 


INI 


10 


<055> 


4 "Aug -77 


HEADS 


BAK 


20 


<055> 


4~Au.g-77 


COM3 


MEM 


140 


<055> 


4-Au£$-77 


COM3 


BAK 


130 


<055> 


4~Au£l -77 


COM3 


RNO 


130 


<055> 


4"-Au£? -77 


TOPS 10 


RNO 


10 


<055> 


4~Ausl--77 


Total 


of 2720 


blocks 


in 29 


files on DSKCt 



1<5) 



dskc : 



C27f5110 



C27y5110.T 



♦ DIR/DETAIL^ 



DSKC 1 1 GHOST *EXEC27y 51 10.1 

Access date* 4-Au.g -77 

Creation time? date* 11*33 28-Jul "77 

Access protect ion* 055 

Mode: 16 

Words written* 2048* 

Version* 1(5) 

Estimated length* 16* 

Blocks allocated* 20* 

Written on* Unit(s) 4 on controller '« 

Data block in directory* 64700* 

Internal creation date* time J 28-- Jul 

RIB block number % 23500* 



2 on CPU 1026 
■77 11J33J38 
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»SKC0JC0MMAN*RN0C27»5il03 

Access date* 4- Au.tf-77 

Creation time? date J 10*09 4-Aus{-~77 

Access protection* 055 

Mode* 1 

Words written* 32* 

Estimated length* 1 ♦ 

Blocks allocated* 10* 

Written oni Unit(s) 3 on controller 1 on CPU 1026 

Data block in directors*. 64700* 

Internal creation datevtinrie* 4-~Au<3-77 10*09*07 

RIB block number J 59880* 

DSKC0 *■ LOGOUT ♦ M 1 C C 27 s 5 1 1 3 

A e cess date* 4 •■■• A u & - 7 7 

Creation time? date? 10*09 4--Ausf--77 
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Function 

The DISMOUNT command allows you to return devices to the 
monitor's pool of available resources, and to remove a file 
structure from the search list. Restricted devices are returned 
to the restricted pool and unrestricted devices to the 
unrestricted pool. In addition, the DISMOUNT command enables you 
(via switches) to reassign an unrestricted device to another job, 
or to retain control of a device you have finished using. When 
this command is applied to non-file structures it is similar to 
the DEASSIGN command. DISMOUNT also handles positioning of 
tapes, reassignment of devices, and FACT file accounting. When 
this command is applied to file structures, it keeps track of 
logged-out quotas and, if necessary, enforces them, allows 
physical removal of disk packs (if there are no other users of 
pack), and removes the file structure name from the job's search 
list. 

If you are a timesharing user, you may continue the job as soon 
as the DISMOUNT command is issued even if operator action is 
required. If you wish to wait for the operator to acknowledge 
the request before continuing with the job, you must specify the 
/WAIT switch (see below) . A batch job always waits until the 
DISMOUNT has been completed, unless the /NOWAIT switch has been 
specified. 

The UMOUNT program, which runs in your core area (with 
privileges), is invoked when the DISMOUNT command is issued. 
This program scans your command string, checks its validity, and 
performs as much of the requested action as possible. The UMOUNT 
program can complete all actions requested by the DISMOUNT 
command except for the action of physically removing packs, 
tapes, or cards. When operator action is required, the UMOUNT 
program writes a command file on [3,3] disk area and notifies the 
OMOUNT program (running on the operator's terminal) to perform 
the action. When the operator action has been completed, OMOUNT 
deletes the command file and notifies UMOUNT (if UMOUNT is 
waiting) to inform the user of completion. 

To ensure validity of any tape error analysis, MOUNT/DISMOUNT 
should be used to acquire and release magtape units. This 
mechanism provides the basis for all media-related error 
reporting. 

Command Format 

DISMOUNT dev: switches 

dev: = any previously ASSIGNed or MOUNTed device or file 
structure name. The name may be a physical or logical name 
(unless the /REASSIGN switch is given, below) or it may be 
NUL: . This argument is required except where otherwise 
indicated. 

/switches = optional switches that can be used to further 
specify the requested action. Switches are processed in the 
order specified by the user. If there are any conflicting 
switches in the command string, the last one scanned is 
used. (An exception to this is the use of both the /WAIT 
and /NOWAIT switches within a single command string. If 
both switches are so specified, a fatal error condition 
results.) If you specify switches that do not apply to the 
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device type these switches are ignored: (DISMOUNT 
DSKB:/REWIND) . Only as few characters as are necessary to 
make the switch unique are required. 



Switch 
/CHECK 



/HELP 



/KEEP 



/PAUSE 

/REASSIGN :n 

/RELEASE 
/REMOVE 



Meaning 

Check and list this job's pending DISMOUNT 
requests. This switch is intended to be used 
without other switches and without a device 
specification. If other switches or a device 
appear in the same command string with the /CHECK 
switch, they will be ignored. 

Types out a brief description of the DISMOUNT 
command and the list of switches that are valid 
with it. This switch is intended to be used 
without other switches, and without a device 
specification. If other switches, or a device, 
appear in the command string with the /HELP 
switch, they will be ignored. 

Retain control of the device for further use. 
Keep the specified device assigned to this job, 
even though it is currently dismounted. This 
switch is intended to be used with non-file 
structure devices. 

Notifies you (giving you an opportunity to cancel 
the request) before queuing the DISMOUNT request 
to the operator. 

Reassign the device to job number n. The device 
must be a physical device name. Restricted 
devices may not be reassigned. 

Release conrol of the device, default condition. 

Removes the file structure from your search list. 
If there are no other jobs using the file 
structure, and if it does not contain essential 
files, the operator is notified that you are 
finished with the device, and it should be 
removed. 



NOTE 

"R" is a valid abbreviation of REMOVE. 
Therefore, if the /REASSIGN, /RELEASE, or 
/REWIND are desired, at least the first 
three characters of those switch names are 
required. 



/REWIND 
/STAY 



Rewind the tape. This switch is ignored if the 
tape has already been rewound or unloaded. 

Do not reposition the device. This is ignored for 
disk. 
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Switch Meaning 

/UNLOAD Unload the tape, default condition for tapes. 



NOTE 

The repositioning switches (/REWIND, /STAY 
and /UNLOAD) are ignored and the default 
repositioning occurs when the /KEEP switch 
is not specified. 



AID: text 



A visual identification passed as a comment to the 
operator. The argument can be up to 50 characters 
in length and may be delimited by single or double 
quotation marks. (The quotation marks are 
included in the 50 characters.) 



/WAIT 



Wait for the operator to 
request before you conti 
is ignored if operator ac 
complete the DISMOUNT: 
file structure that other 
default for batch jobs 
can be used without a de 
without other switches: 
pending DISMOUNT requests 
is the default condition 



acknowledge the DISMOUNT 
nue the job. This switch 
tion is not required to 

a DISMOUNT command for a 

s are using. This is the 

Also, the /WAIT switch 

vice specification, and 

the job waits for all 

to be completed. /WAIT 
for batch jobs. 



/NOWAIT 



Does not wait for the operator to acknowledge 
DISMOUNT requests before allowing you to continue 
the job. This is the default condition for 
time-sharing jobs. 



Characteristics 

The DISMOUNT command: 



Places the terminal in user mode. 

Runs the UMOUNT program, thereby destroying the user's core 

image. 



Examples 



♦ ASSIGN niA SCRATCH ^ 
DTA010 ASSIGNED 

♦ DISMOUNT SCRATCH ^ 
DTA010 DISMOUNTED 

This DISMOUNT command ends the association between the logical 
name SCRATCH and the physical drive DTAO, releases the drive DTAO 
from this job, and queues a request to the operator to remove the 
DECtape from the drive. You refer to the drive by the logical 
name (SCRATCH) ; had you referred to the drive by the physical 
name (DTAO), the command would have had the same effect. 

♦ ASSIGN MTA FAILSA V 
MTA010 ASSIGNED 

♦ DISMOUNT FAILSA/KEEP/REUIIND ^ 
MTTA010 DISMOUNTED 
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. SYSTftT ,^J 



7 10 r 4072 


TTY11 


SYSTAT 1 


* MEANS EXECUTE 


ONLY 




busy devices: 






DEVICE JOB 


WHY 


LOGICAL 


MTA010 7 


AS 


FAILSA 



12+SPY RN 



4$ 



This DISMOUNT command causes the tape to be rewound, but does not 
queue a request to the operator. Because the command includes 
the /KEEP switch, the driver remains assigned to the job, and the 
logical name remains associated with the drive. The only effect, 
then, is to rewind the tape. 



♦ SYSTAT 7 9 *J 

7 10 r 4072 TTY11 
* MEANS EXECUTE ONLY 



SYSTAT 



12+SPY 



RN 



BUSY DEVICES? 
DEVICE JOB WHY 

MTAO 10 7 AS 

9 10? 4072 DET 



LOGICAL 
FAILSA 



S C SW 



* D I SMOUNT FA I LS A/RE ASS I GN : 9 *J 
MTA010 DISMOUNTED 



. SYSTAT « 9 ^J 

7 10 9 4072 TTY11 
$ MEANS EXECUTE ONLY 



SYSTAT 



12+SPY 



RN 



6$ 



10 » 4072 DET 



"C SW 



BUSY DEVICES! 
DEVICE JOB WHY 

MTA010 9 AS 



LOGICAL 



This example shows that job 7 has MTAO assigned to it, and the 
logical name FAILSA is associated with MTAO. At this time job 9 
has no devices assigned to it. The DISMOUNT command releases 
MTAO from job 7 and assigns it to job 9. The association between 
the logical name FAILSA and MTAO is no longer in effect for job 
7. While job 9 now has MTAO assigned to it, there is no logical 
name associated with MTAO any more. The tape itself is unloaded. 

♦ DISMOUNT BLKJ/REM0VE ^7 
BLKJ DISMOUNTED 



Here, you knew that the job was the only one using 
BLKJ, and included a /REMOVE switch, so that the 
physically remove the disk pack from the drive. 
"BLKJ DISMOUNTED" means that BLKJ is no longer 
list, and that a request has been queued to the 
remove the pack from the drive. The message does 
BLKJ has already been physically removed. Since 
implies /NOWAIT, you will not receive notific 
physical removal of the disk pack. 



the structure 

operator would 

The message 

in your search 

operator to 

not mean that 

this command 

ation of the 
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♦ DISMOUNT/CHECK ^/ 

1. D J0B7 TTY111 1 Ov 4072 1 DISMOUNT BLKJ /R 

1 COMMAND IN QUEUE 

The response to the DISMOUNT/CHECK command indicates which of 
this job's dismount requests are still pending, and the total 
number of pending dismount requests in the system. Here, BLKJ 
has not yet been physically removed. 

♦ DISMOUNT/WAIT ^ 

NONE PENDING FOR YOUR JOB 



The DISMOUNT/WAIT command causes the job to suspend further 
processing until all pending dismount requests from it have been 
completed. Here, at the time that the DISMOUNT/WAIT command was 
issued, there were no pending dismount requests from this job, so 
the job returns to monitor command level immediately. 

♦ DISMOUNT DSKB/REMOVE ^/ 

7. DSKB HAS OTHER USERS - /REMOVE IGNORED 

DSKB DISMOUNTED 

♦ R SETSRC ^/ 

dska:/nocreatet dskc:» dskn:* fence 

In this example, you requested that DSKB be removed from the 
search list and physically removed from the disk drive. DSKB is 
removed from the job's search list, but since there are other 
jobs using DSKB, a request to physically remove the pack is not 
queued to the operator. 
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Function. 

The DSK command prints disk usage for the combined structures of 
the job, since the last DSK command, followed by the total disk 
usage since the job was initialized (logged in) . Disk is typed 
in the following format: 

RD,WT = i,j 
RD,WT = m,n 

where i and j are the incremental number of 128-word blocks read 

and written since the last DSK command, and m and n are to total 

number of 128-word blocks and written since the job was 
initialized. 

NOTE 

i and j are kept modulo 4096. If automatic READ or WRITE 
print outs have been enabled using the SET WATCH command, 
i and j are usually zero, since the SET WATCH output also 
resets these values. 

Command Format 
DSK job 

job = the job number of the job for that the disk usage is 
desired. This argument is optional. 

If job is omitted, the job to which the terminal is attached 
is assumed. 

If job is supplied (whether the job of this user or another 
user) the incremental quantities are not reset to zero. 

Characteristics 

The DSK command: 

Leaves the terminal in monitor mode. 
Example 

RD»UT«0r0 
RD»WT=66y6 
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Function 

The DTCOPY program is a DECtape copy routine that allows the user 
to 

1. Copy the entire contents of an input DECtape to an output 
DECtape. 

2. Zero all blocks on an output DECtape and clear the directory. 

3. Perform a word-by-word comparison of two DECtapes. 

4. Load a bootstrap loader and write it in books 0, 1, and 2 of 
the output DECtape. 

Command Format 

.R DTCOPY 

*output DTA: = input DTA:/switches 

/switches = one or more of the following switches. Switches 
are preceded by a slash or enclosed in parentheses and can 
appear anywhere in the command string. 

/C Copy all blocks from the input DECtape to the 
output DECtape. 

/H Do not restart the program after a parity error. 
Output an error message and continue the program. 

/H Type the available switches and their meanings. 

/L Load the bootstrap loader into a core buffer. 
DTCOPY expects the loader to be on logical device 
PTR in the file named BSLDR.REL. Note that DTCOPY 
must be SAVed if the loader is to be preserved with 
the DTCOPY core image. 

/N Suppress the directory listing. 

/T Write the bootstrap loader in blocks 0, 1, and 2 of 
the output DECtape. This switch accepts, as input 
from the terminal, a core bank or offset. The 
loader is offset and then written on the tape. 

core bank = nnnK (16K to 256K) 
offset = 100 to 777600 octal 

/V Verify the similarities of the two DECtapes by 
performing a word-by-word comparison and typing on 
the terminal the number of discrepancies 
discovered. 

/Z Zero all blocks of the output DECtape and clear the 
directory. 

/6 Look for the directory in PDP-6 format (i.e., in 
block one instead of block 144) . 



2-62 



DTCOPY Program (Cont.) 



If no switches are specified, /C (copy) and /V (verify) are 
assumed by default. Upon completion, the directory in core 
may not agree with the directory of the output DECtape. The 
output DECtape should be reassigned to guarantee that the 
directory in core is up-to-date. 

Characteristics 

The R DTCOPY command: 

Places the terminal in user mode. 

Runs the DTCOPY program and consequently destroys your core 

image. 

Examples 

« R DTCOPY ^J Run DTCOPY 

ft D T A :l. 7 : « D TAP :l. 3 X +J Copy the contents of DTA3 to DTA7 and 

determine if the two DECtapes are the same 

(default condition) . If the DECtapes 

disagree, the number of discrepancies is 
typed on the terminal. 

% DTA002?/Z ^y Zero all blocks and clear the directory on 

DTA2. 

*2C. Return to monitor mode. 

♦ A 8 S 1 G N D S K t P T R * ^J The bootstrap loader must be on logical 

device PTR. 

♦ RENAME BSLDR ♦ REL«DTBOQT ♦ REL ^ 

COPY expects the bootstrap loader to be named 
BSLDR. 

♦ R DTCOPY ^J Run DTCOPY. 

ft/L.^7 Load the bootstrap loader into a core buffer. 

* ~C Return to monitor mode. 

. SAVE DSK^ y Save DTCOPY so that the bootstrap loader is 
♦ OSAVE DSKtCQPY ^y preserved with the DTCOPY core image. 

♦ STAR TS Start the COPY program. 

&DTA5 Write the bootstrap loader in blocks 0, 1, 

* /T " and 2 of DTA5. 

TYPE CORE BANK AND OFFSET FOR DTBOOT 

Respond with size of core bank or offset. 

64K Size of core bank (64K core bank = 177000 

offset, top of core - 1000) . 

*"C Return to monitor code. 



2-63 



DUMP Command 



Function 

The DUMP command calls the DAEMON program to write a core image 
file (function of the DCORE command) and then invokes the DUMP 
program to analyze the file written and to provide printable 
output. The core image file is named nnnDAE.TMP where nnn is 
your job number. This file is described in detail in the DCORE 
command description. 

Command Formats 

1. DUMP/command/command/command. . . 

2. DUMP @ dev:file.ext [directory] 

3. DUMP 

Commands that appear in the DUMP command string are passed to the 
DUMP program, and are described in the DUMP program description. 
A DUMP command using a command file can also specify these 
commands. A DUMP command without any arguments prints a short 
dump of the user's core area via the command file QUIKDM.CCL that 
resides on device SYS:. 

Characteristics 

The DUMP command: 

Leaves the terminal in monitor mode. 

Runs the DAEMON and DUMP programs, thereby destroying your 

core image. 



Example 



» DUMP/OUT i TTY t /MODE t ASCI I ♦ SIXBI T/tJIDTH t 7 > 10/ JUST«L * R« *J 
/RIGHTMA:26/D C3000 & 3004 3 ^ 

This command string writes a core image file names nnnDAE.TMP and 
invokes the DUMP program to perform the output. The output goes 
to the terminal and the modes used on output are ASCII and 
SIXBIT. The ASCII field is 7 characters long, left justified and 
the SIXBIT field is 10 characters long, right justified. The 
right margin of the output is 26 characters. The dump consists 
of the contents of word 3000 to word 3004. The hyphen is used to 
continue the command string onto the next line. 
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Function 

The DUMP program 
in modes and fo 
any data file as 
listing by PIP 
For example, the 
the DAEMON progr 
description of 
command. Comple 
in the DUMP Spec 



provides printable 
rms you have specifi 

input and produces 
, the output spooler 

DUMP program takes 
am or SAVEd files pr 
the DAEMON-written 
te documentation on 
ification and in the 



dumps of arbi 
ed. The DUMP 
an ASCII fil 
s, or other 1 
core image fi 
oduced by the 

file, refer 
the DUMP prog 

DUMP Referen 



trary data 

program a 

e suitabl 

isting pro 

les prepar 

monitor. 

to the 

ram is con 

ce Manual. 



files 
ccepts 
e for 
grams, 
ed by 
For a 
DCORE 
tained 



Command Formats 

1 . R Dump 
/command 

2. R DUMP 

/@dev: f ile.ext [directory] 



NOTE 

DUMP indicates its readiness by typing a slash (/) 
instead of asterisk. 



The commands with their arguments are as follows. Lines can 
continued by typing a hyphen followed by a carriage return. 



be 



Command 
ADDRESS 



Argument 
ON or OFF 



Meaning 

Specifies if the address 
is to be dumped along with 
its contents. The default 
is ON. 



ALL 



APPEND 



AUTOFORMAT 



ON or OFF 



Dumps the entire file. If 
the file is a DAEMON core 
image file, the entire 
category is dumped. 

Appends the output to the 
output file. The existing 
output file is not 
overwritten. This command 
is the default; its 
complement is SUPERSEDE. 

Attempts to format output 
with line feeds, form 
feeds, and titles, if ON. 
If OFF, the user is 
responsible for all 
formatting. The default 
is ON. 
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Command 
CATEGORY 



Argument 

mnemonic for 
name of 

category. Can be 
JOB, 

CONFIGURATION, 
DDB, CORE, or 
FEATURES 



CLOSE 



DUMP or D 



dump restrictor, 
dump descriptor. 



Meaning 

Selects the category of 
the DAEMON dump file to be 
used. Addressing begins 
with at the beginning of 
each category. The 
default category is CORE. 
If the input file is not a 
DAEMON file, this switch 
has no effect. Note that 
the DUMP program does not 
display the category 
header nor does it allow 
you to read past the end 
of one category into the 
next category. 

Closes the output file. 
After this command is 
given, another OUT command 
must be given before the 
next command which does 
any output, or else a 
fatal error message will 
result. 

Dumps the specified bytes 
in the current modes. 



EJECT 



Starts a new page 
output file. 



in 



the 



EXIT 



HELP or H 



INPUT or I 



file descriptor 



Closes all files and 

returns control to the 

monitor (CTRL/Z has the 
same effect) . 

Types the help text on 
your terminal. To list 
the names of all the 
switches, you type 
HELP: SWITCHES. 

Specifies the input file. 
The defaults are: 
DSK:nnnDAE.TMP where nnn 
is the job number; your 
directory. If the file 
name is specified, it 
determines the extension 
from the set .TMP, .DAE, 
.SHR, .SAV, .HGH, .LOW, 
.XPN, and .DMP in that 
order. If an extension is 
specified with no file 
name, the extension 
determines the file name. 
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Command 
I RAD IX 



Argument 
decimal number 



Meaning 



JUSTIFY 



LEFT, CENTER, 
or CENTER 



LEFTMARGIN 



LINEPAGE 



expression 



expression 



MODES or M 



ALL, ASCII, DECIMAL, 
NULL, NUMERIC, 
OCTAL, RADIX50, 
SIXBIT, SOCTAL, or 



Specif i 
numbers 
command 
compute 
default 
The a 
numeric 
is 
input r 
its def 



es 
for 
use 
the 
is 1 
rgume 
. If 
and i 
adix 
ault 



radix 
input 
s deci 
argumen 
for d 
nt mu 

the a 
s missi 
is set 
value. 



for 
This 
mal to 
t. The 
ecimal. 
st be 
rgument 
ng, the 
back to 



Specifies the justifi- 
cation of the output in 
the output field. If the 
output overflows the 
output field, the entire 
output appears; it is not 
truncated. This switch is 
used in a one-to-one 
relationship with the MODE 
and WIDTH commands. If 
there are more MODE 
commands, an argument of 
LEFT is used. If there 
are more JUSTIFY commands, 
they are ignored. 

Sets the left margin of 
the output file. The 
default is 0. 

Specifies the number of 
lines per output page. 
This counts all lines 
including blank lines and 
titles. The default is 
50. 

Selects the type of 
output. All dumps in all 
modes. ASCII dumps the 
word as a single right 
justified character if 
bits 0-28 are zero or as 5 
left justified ASCII 
characters if bits 0-28 
are nonzero. Non-printing 
characters print as a 
space. DECIMAL dumps as a 
signed decimal number. 
NULL declares that nothing 
is to be dumped. NUMERIC 
dumps as a signed number 
in the current output 
radix. OCTAL dumps as 
half-words separated by a 
comma (default) and takes 
13 positions. RADIX50 
dumps in RADIX 50. SIXBIT 
dumps as one right 
justified SIXBIT character 
if bits 0-29 are zero, or 
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Command 



Argument 



Meaning 

6 SIXBIT characters if 
bits 0-29 are nonzero. 
SOCTAL dumps as signed 
octal and suppresses 
leading zeroes. SYMBOLIC 
dumps as a symbolic 
instruction. 

Any mode specification can 
appear more than once in 
the command string. The 
output is in the same 
order as the MODE list. 



NUMPAGE 



expression 



Specifies that pages are 
to be numbered. If 
expression is 0, page 
numbering is turned off. 
If expression is not f 
page numbering begins at 
page = [expression] . If 
command is omitted, 
numbering starts at the 
first page. 



OPTION 



: name 



Reads your option file 
(DSK: SWITCH. INI [.] 
/PHYSICAL) to determine 
your specified switch 
defaults for this program. 
The option name appearing 
as the value of the switch 
is the pointer to the line 
to read in the file. For 
example, if the file 
contains the line 



DUMP : OCT/IRADIX : 8/ORADIX : 8 

then you reference this 
line by typing to DUMP 

/OPTION: OCT 

If SWITCH.INI has a line 
of the form 

DUMP/sw itch/switch 

then the specified 
switches override the 
normal DUMP defaults. For 
example, if you do not 
want the address dumped, 
you can place the line 

DUMP/ADDRESS: OFF 
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Command 



Argument 



Meaning 

in the file. If you want 
the addresses dumped for a 
particular dump, you must 
override the file by 
giving the command 

/ADDRESS: ON 

to DUMP. 



ORADIX 



decimal number 



OUTPUT or file descriptor 



Specifies radix for 
numbers for output. The 
default is 10 for decimal. 
If number is 0, the 



standard 
argument 



is used. The 
to this command 



is decimal and must not be 
an expression. 

Specifies the output file. 
The defaults are: LPT: , 
the file name of the input 
file; the extension .LSD; 
the user's directory. If 
a file name is given, the 
device DSK: is assumed. 



RIGHTMARGIN expression 



RUN 



program 



Sets the ri 
the output 
may overfl 
margin if 
between the 
margins. 
ON , the new 
an address 
page overf 
title line 
printed. 



ght margin of 
file. A field 

ow the right 

it will not fit 
left and right 

If ADDRESS is 

line will have 

typed. If a 

low occurs, a 
may also be 



Runs the specified 
program. This command is 
equivalent to the R 
monitor command. 



SUPERSEDE 



Specifies that the output 
is to supersede an 
existing file of the same 
name, if there is one. 
The complement of this 
command is APPEND, which 
is the default. 



SYFILE 



file descriptor 



Specifies the file to take 
symbols from if XTRACT 
command is specified. 
Defaults are: DSK:, the 
file name of the input 
file; one of the saved 
file extensions; your 
directory area. 
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Command 
TDUMP or T 

TITLE 



Argument 

dump descriptor, 
dump descriptor,... 

string of characters 



TYPE"! 



DAE, DAT, HGH, 
LOW, SAV, SHR, 
XPN, EXE 



WIDTH 



expression 



XTRACT 



Meaning 

Dumps specified bytes to 
both output file and TTY. 

Specifies a title to be 
included in the subsequent 
page headings. If no 
argument is specified, 
titling is turned off. 

After this command, an 

EJECT command should be 

given to skip to a new 
page. 

Specifies the format of 
the input or symbol file. 
DAE specifies the file is 
generated by DAEMON. DAT 
specifies file is a data 
file (i.e., no special 
format; therefore, no 
special processing is 
done) . HGH specifies file 
in .HGH format; LOW in 
.LOW format; SAV in .SAV 
format; SHR in .SHR 
format; XPN in .XPN 
format; EXE in .EXE 
format. 

Selects the width of each 
output mode (see the MODE 
and JUSTIFY commands). If 
a MODE command is 
specified without a 
corresponding WIDTH, the 
byte is dumped in exactly 
the number of positions 
required followed by 3 
blanks. If a WIDTH 
command is specified, no 
free blanks are output. 
If a MODE specification 
overflows its WIDTH 
specification, the entire 
output is given without 
justification. If 

expression is omitted, 
justification is turned 
off. 

Uses the file specified in 
the last SYFILE command as 
a core image and extracts 
the symbol table. 



1. If TYPE is not specified, the extension of the input file is used 
to determine the type of file being produced. If the extension is not 
one recognized in the TYPE command, TYPE DAE is assumed. 
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An expression is an octal/decimal number , an arithmetic operation. 
("•"/ " t *r /r ' / or grouped within parentheses), contents operator. 
([, \, and @) , or a symbol. 

$ (the last byte typed out) . 

(the address of the last word dumped) , and 
% (the last expression evaluated). 

A dump descriptor is any of the following: 

1. A text string enclosed in single quotes which contains 
alphanumeric characters and special patterns. The following 
patterns represent nongraphic characters and are replaced in 
the output by the action represented. 

<EL> - end line, CR/LF 

<VT> - vertical tab 

<FF> - form feed 

<AL> - altmode 

<HT> - horizontal tab 

"<letter> - control character 

\<letter> - lower case character 

To override special patterns, a double quote indicates that 
the next character is to be represented as is, without 
including it as part of a special pattern. 

2. A byte descriptor describing the byte in the input file to be 
dumped. The format is: 

word <pos.size> 

where: 

word = the address of the word desired. 

pos = the position of the byte within the word. It 
specifies the bit number of the leftmost bit in the 
byte. 

size = the number of bits in the byte. It may be any 
size and can cross word or block boundaries. 

3. A byte descriptor limit specifying everything from the first 
byte descriptor to the second. The format is as follows: 

<FROM byte descriptor> & <TO byte descriptor> 

A file descriptor consists of a device name, a file name with an 
extension, and a directory name. 

Characteristics 

The R DUMP command: 

Places the terminal in user mode. 

Is used with disk monitors only. 

Runs the DUMP program, thereby destroying your core image. 
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Example 

♦ DCQRE ^ 

♦ rjdumpV 

/XTRACT ^ 

s w in h a 1 «» e X T R A C T g? d 
/MODE SYM f OCT r DEC ^ 
TtJIDTH 3Qyl5yl5 ^ 
/JUST I FY L y R y R y R y R ^ 
/OUT TTYt^ y 
/RIGHTMARGIN 70 ^ 
/I RADIX 8 ^/ 
/DUMP CI 40 81 44 3^ 



140/ 


ADD.T 


ly2 


141/ 


CAMGE 


1 y 370 


142/ 


JRST 


401640 


143/ 


PUSH 


17 y 6 


144/ 


MOVE I 


6yl3 


Z 






/EXIT 







000000 



271 040 y 000002 
315040 y 000370 
254000 y 401640 
261 740 y 000006 
20 1 300 y 0000 13 
000000 



24838668290 
27523023096 
23085581216 
23882366982 
17364418571 




EXIT 
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Function 

The E command examines a core location in your area (high or low 
segment) . 

When running under a virtual memory system, DAEMON will be called 
on execution of the E command, if the page in question is paged 
out. 

Command Format 

E addr 

addr is required the first time the E or D command is used. 
If addr is specified, the contents of the location are typed 
out in half-word octal mode. 

If addr is not specified, the contents of the location 
following the previously specified E addr or the location of 
the previous D addr (whichever was last) are typed out. 

Characteristics 

The E command: 

Leaves the terminal in monitor mode. 
Requires core. 



Example 



*E 140 ^7 

000140/ 000000 000000 *J£^J 
000141/ 312000 400033 *JL^ 
000142/ 000000 000000 
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Function 

The EDIT command opens an already existing line sequence-numbered 
file on disk for editing with LINED (Line Editor for disk). 
Refer to the LINED writeup in the DECsystem-10 Software 
Notebooks. 

Command Format 

EDIT file.ext 

file.ext = a file name and file name extension of an 
existing file. This argument is optional if a CREATE or 
EDIT command has been given since the initialization of the 
job, because the arguments of the EDIT-class commands are 
remembered in temporary files on the disk or in core if the 
monitor has the TMPCOR feature. 

Characteristics 

The EDIT command: 

Places the terminal in user mode. 

Runs the LINED program, thereby destroying your core image. 



Example 



♦ EDIT DCORE ^ 
* 



1 This command runs the COMPIL program, which interprets the command 
before running LINED. 
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Function 

The EOF command writes an end-of-file mark on the specified 
magnetic tape. This command is equivalent to the following PIP 
command string: 

MTAn: (MF) = 

Command Format 
EOF MTAn: 

More than one magnetic tape can be specified in the command 
string by separating the tape specifications with commas. 

Characteristics 

The EOF command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying your core image. 

Examples 

♦ EOF MTA003? ^ 

TDEVICE MTA003 NOT AVAILABLE 

♦ EOF MTA013:^ 



1 This command runs the COMPIL program, which interprets the command 
before running the PIP program. 
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Function 

The EXECUTE command translates th 
necessary (function of COMPILE 
generated into a core image (fu 
begins execution of the progr 
proper language translator to use 
or from switches you specify i 
the COMPILE command.) If a REL fi 
date than that of the source f 
the file unless you request this 



e source files you specify if 
command) , loads the REL files 
net ion of LOAD command) , and 
am. The system determines the 
from the source file extensions 
n the command string. (Refer to 
le already exists with a newer 
ile, the system does not compile 
explicitly via a switch. 



This command is equal to a LOAD and START sequence of commands. 

Each time you issue a COMPILE, LOAD, EXECUTE, or DEBUG command, 
the system remembers the command with its arguments in a 
temporary file on disk, on in core if the monitor has the TMPCOR 
feature. Therefore, when you issue one of these commands without 
specifying any arguments, the system uses the arguments that it 
saved in the temporary file (refer to Section 1.5). 

The EXECUTE command accepts several command constructions: the @ 
construction (indirect commands) , the + construction, the = 
construction, and the < > construction. Refer to Section 1.5 for 
a complete description of each of these constructions. 

Command Format 

EXECUTE list 

list is a single file specification or a string of file 
specifications separated by commas. A file specification 
consists of a device name, a file name with or without an 
extension, and a directory name. (Refer to Section 
1.4.2.4.) 

You can use the following switches to modify the command 
string. These switches can be temporary or permanent 
switches unless otherwise stated. (Refer to Section 1.5.5.) 



Switch 
/ALGOL 



Meaning 

Compile the file with ALGOL. Assumed 
files with the extension of .ALG. 



for 



/BIN 



Generate a binary file for each file 
compiled. The file name for the binary file 
follows the standard conventions for 
determining the name of the output file. 
(Refer to Sections 1.5.2 and 1.5.3.) 
extension is .REL. This is the default 
action. 



/BLISS 
/COBOL 



Compile the file with BLIS10. Assumed for 
files with the extension of .BIO or .BLI. 



Compile the file with COBOL. Assumed 
files with the extension of .CBL. 



for 



This command runs the COMPIL program, which interprets the command 
before running the appropriate language translator for the LOADER. 
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Switch 
/COMPILE 



/CREF 



/FOROTS 

/FORSE 

/FORTRAN 



/FUDGE 



Meaning 

Force a compilation on this file even if a 
binary file exists with a newer date and time 
than the source file. You can use this 
switch to obtain an extra compilation (e.g., 
in order to obtain a listing of the 
compilation) because, normally, the system 
does not perform compilation if the binary 
file is newer than the source file. 



Produce a cross-reference 
disk for each file 
processing by the CREF 
name for the listing 
standard conventions for 
of the output file. (Ref 
and 1.5.3.) The extension 
then list the files usi 
However, with COBOL files 
the cross-referenced li 
file. You need not issue 
obtain the listing. 



listing file on the 
compiled for later 
program. The file 
file follows the 
determining the name 
er to Sections 1.5.2 

is .CRF. You can 
ng the CREF command. 
, the system appends 
sting to the listing 

another command to 



Load the file with FOROTS, 
object-time system. 



the new FORTRAN 



Load the file with FORSE, the old FORTRAN 
object-time system. 



Compile the fil 
Assumed for f 
and .FOR and al 
translator ex 
standard transl 
this switch if 
translator exte 
standard trans 
default (e.g. 
FIL3/FORTRAN) . 



e with a FORTRAN compiler, 
iles with the extension of .F4 
1 files with nonrecognizable 
tensions if FORTRAN is the 
ator. You need to specify 
the file has a nonrecognizable 
nsion and FORTRAN is not the 
lator or is not the current 
, EXE/ALGOL FILl, -FIL2, 



Create a disk file containing the names of 
the .REL files produced by the command 
string. When you issue the FUDGE command, 
PIP reads this file in order to generate a 
library .RELfile. (Refer to the FUDGE2 
program description.) Arguments to this 
switch are: 

/FUDGE :dev: file. ext [proj,prog] 

dev: is the device on which to write 
the file. If you omit the device, the 
system assumes DSK. 

file. ext is the name of the library 

file. The file name is required. If 

you omit the extension, the system 
assumes .REL. 

[proj,prog] is the directory in which to 

place the file. Your directory is 

assumed if you do not specify a 
directory. 
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Switch 



/F10 



/F40 



/KA10 
/KI10 



/LIBRARY 



/LINK 



/LIST 



/LMAP 

/LOADER 
/MACRO 



Meaning 

This switch is permanent in the sense that it 
pertains to all REL files generated by the 
command string. 

Use the FORTRAN-10 compiler when compiling 
the associated FORTRAN file. This should be 
used as a permanent switch because it is not 
possible to load F40 and FORTRAN-10 binary 
files together. 

Use the F40 compiler when compiling the 
associated FORTRAN file. This should be used 
as a permanent switch because it is not 
possible to load F40 and FORTRAN-10 binary 
files together. 

Designate the machine on which the program 
will execute once it has been loaded. These 
switches are needed for FORTRAN-10 programs 
because the compiler generates different code 
for the KA10 and KI10 processors. The 
default is the processor on the computer 
executing the command. 

Load the files in library search mode. This 
mode causes a program file in a special 
library file to be loaded only if one or more 
of its declared entry symbols satisfies an 
undefined global request in the source file. 
The system libraries are always searched. 
(Refer to the LOADER and LINK-10 
documentation. ) 

Cause the file to be loaded by the LINK-10 
linking loader. If you use this switch, you 
should place it before any file 
specifications because the COMPIL program may 
have to generate load-control switches. This 
is the current default action. 

Generate a disk listing file for each file 
compiled. The file name for the listing file 
follows the standard conventions for 
determining the name of the output file. 
(Refer to Sections 1.5.2 and 1.5.3.) The 
extension is .LST. You can later list these 
files using the LIST command. If the line 
printer is being spooled for your job, the 
system writes the listing files on device LPT 
and automatically spools them at LOGOUT time. 
Unless you specify this switch, the system 
does not generate the listing files. 

Produce a loader map during the loading 
process (same action as /MAP) containing the 
local symbols. 

Cause the file to be loaded by the LOADER. 

Assemble the file with MACRO. Assumed for 
files with extensions of .MAC. 
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Switch 
/MACY11 1 

/MANTIS 2 
/MAP 



/NEW 



/NOB IN 



/NOCOMPILE 



/NOLI ST 
/NOMANTIS 2 

/NOSEARCH 



Meaning 

Assemble the file with MACYll. 
files with extensions of .Pll. 



Assumed for 



Compile the file with the MANTIS debugging 
information. This switch affects F40 files 
only. 

Produce loader maps during the loading 
process. When this switch is encountered, a 
loader map is requested from the loader. 
After the library search of the system 
libraries, the map is written in your disk 
area with either the file name specified by 
you (e.g., /MAP:file) or the default file 
name MAP. MAP if loading is performed by 
LOADER or the default name nnnLNK.MAP if it 
is performed by LINK-10. This switch is an 
exception to the permanent switch rule in 
that it causes only one map to be produced 
even though it appears as a permanent switch. 

Run the appropriate language translator from 
the experimental system library (device NEW:) 
area [1,5]. If the translator does not exist 
on device NEW: , try to obtain it from device 
SYS:. (Refer to the following NOTE.) 

Do not generate binary files. Unless you 
issue this switch, the system does not 
generate binary files. This switch, when 
combined with the /CREF or /LIST switch, is 
useful when compiling programs solely for the 
purpose of generating listings. 

Complement the /COMPILE switch by not forcing 
a compilation on a source file whose date is 
not as recent as the date on the binary file. 
Note that this switch is not the same as the 
/REL switch, which turns off all compilation, 
even if the source file is newer than the REL 
file. /NOCOMPILE is the default action. 



Do not generate listing files, 
default action. 



This is the 



Compile the file without the MANTIS debugging 
information. This switch affects F40 
programs only. 

Loads all routines of the file whether the 
routines are referenced or not. Because this 
is the default action, this switch is used 
only to turn off library search mode 
(/LIBRARY) . This is not equivalent to the /P 



MACYll, the PDP-11 assembler for the DECsystem-10, will be 
recognized as a translator only if the appropriate assembly switch is 
set. However, this assembly switch setting is not supported. 

MANTIS will be recognized as a debugging program only if the 
appropriate assembly switch is set. However, this switch setting is 
not supported. 
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Switch 



/OLD 



/REL 

/SEARCH 

/SELF 



/SNOBOL 1 
/SYS 



Meaning 

LOADER switch, that does not search any 
libraries; the /NOSEARCH switch scans the 
system libraries. 

Run the appropriate language translator from 
the system library of old programs (device 
OLD:) which resides on the disk area [1,3], 
If the translator does not exist on device 
OLD:, try to obtain it from device SYS:. 
(Refer to the following NOTE.) 

Use the existing REL files although newer 
source files may be present. 

The action is identical to that of the 
/LIBRARY switch. 

Run the appropriate language translator from 
device DSK: instead of from the system 
library (device SYS:). This switch is useful 
for an individual who keeps a private copy of 
a translator in his own disk area. System 
programmers occasionally keep experimental 
versions of standard translators in their 
disk areas to test new features. (Refer to 
the NOTE below. ) 



Compile the file with SNOBOL. Assumed 
files with an extension of .SNO. 



for 



Run the appropriate language translator from 
the system library (device SYS:) area [1,4]. 
This is the default action. 



NOTE 

A processor appearing more than once 
within a single command string cannot 
specify more than one disk area. For 
example, the following is illegal: 



. EXECUTE PARTA . F4 0/NEW, PARTB . F40/OLD 

However, the following is valid: 

.COMPILE PARTA. F40/NEW 
.COMPILE PARTB. F40/OLD 
.EXECUTE/REL PARTA, PARTB 



SNOBOL will be recognized as a language translator only if the 
appropriate assembly switch is set. However, this assembly switch 
setting is not supported. 
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Characteristics 

The EXECUTE command: 



Places your terminal in user mode. 

Runs the appropriate language translator and linking-loader , 
thereby destroying your original core image. 

Starts the execution of the compiled and loaded program. 



Excimples 



. EXECUTE TESTER ^ 
FORTAN TESTER 
LOADING 

LINK 2K CORE 
EXECUTION 
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Function 

The FAILSA program is used by operators and users alike to save 
disk files on magnetic tape and to later place all or some of 
these saved files back onto the disk. Although this program is 
normally used by the system operator, you, as the console user, 
can execute a subset of the FAILSA operations for your disk area. 
You can save your disk area on your own magnetic tape and later 
restore all your files or a subset of your files back to your 
area. Or you may need to restore from the system FAILSA tape one 
of your files that you unintentionally deleted from your area. 
You can also use the program for moving your files from one 
system to another. (Complete documentation on the FAILSA program 
is contained in the FAILSA specification in the DECsystem-10 
Software Notebooks . ) 

NOTE 

Crucial to FAILSA' s operation is the 
fact that the magnetic tape used must be 
assigned the logical name FAILSA. 

Command Format 

.R FAILSA 
*/switch 

FAILSA switches with their explanations are as follows. A 
carriage return is used to terminate all switches. 

Switch Explanation 

/A Advances the magnetic tape one physical file. 

/B Backspaces the magnetic tape one physical file. 

/C Causes FAILSA to continue. 

1. On disk-to-tape transfers, if the end of tape 
is reached before all disk files have been 
saved, FAILSA requests that you mount a new 
tape and type /C after the tape has been 
mounted to direct FAILSA to continue. 

2. On tape-to-disk transfers, after FAILSA has 
typed out the number of the mounted tape and 
its creation time and date, you type /C if 
this information is correct and you wish all 
files on the tape to be restored on disk. 
This feature aids in preventing accidental 
restoration of files from the wrong tape. 

/D Transfers control of DDT if it is loaded. 

/E Sets creation date and time word so old files can 
be eliminated by not being transferred in either 
direction. The format is as follows: 

*/Emm/dd/yy , tttt<carriage return> 
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Switch Explanation 

where mm is the numerical month, dd is the day of 
the month, yy is the last two digits of the year, 
and tttt is the time expressed in 24-hour time. 
If this switch is not specified, Jan. 1, 1964, 
0000 hours is used. 

/F Sets access date word. This switch is used to 
transfer, in either direction, only recently 
accessed files or to save on tape and then delete 
from disk not recently accessed files (/K before 
/S or /U) . The format is as follows: 

*/Fmm/dd/yy/<carriage return> 

where mm is the numerical month, dd is the day of 

the month, and yy is the last two digits of the 

year. If this switch is not specified, Jan. 1, 
1964 is used. 

/G Enables you to save and restore files from a 
user's area other than your own. This switch sets 
the source project, programmer number to the 
specified number. The format is as follows: 

*/Gmmm,nnn<carriage return> 

This changes the single, user project, programmer 
number switch from that of the FAILSA user to 
mmm,nnn. The new value is retained until the next 
/G switch. If you do not issue this switch, your 
project, programmer number is used. 

/H Prints a summary of FAILSA operating procedures on 
your terminal. 

/I Sets the magnetic tape density to the installation 
standard. 

/J Looks for the next trailer record (which marks the 
end of a save set) and points to the beginning of 
the next save set on the tape or to the logical 
end of tape, if there is no save set. In the 
first case, the tape is positioned in such a way 
that a tape read command will execute properly or 
a tape write command will overwrite the existing 
save set. If there is no save set on the tape, 
the tape is positioned between the two end of file 
marks designating the logcal end of tape, so that 
a succeeding tape write (/S or /U) will execute 
properly. Use the /A switch to position the tape 
after MAGRIM and/or SAVE and SSAVE header files. 

/K Deletes not-recently accessed files from disk and 
copies them to a magnetic tape. (This is known as 
the skim operation because, in one pass, the disk 
is being skimmed of certain files and at the same 
time these files are placed on the tape.) Used in 
conjunction with /S or /U. Note that certain 
project, programmer numbers may be exempted from 
this process. 
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Switch Explanation 

/L Types on your terminal a directory of all your 
files on the tape. FAILSA checks your project, 
programmer number and uses it to find the correct 
area of the tape. Only the file names and 
extensions are typed. This switch is similar to 
the /F switch in PIP. 

/M Initiates multiple saves. Saves are taken every 
SLPMIN minutes, where SLPMIN is an assembly 
parameter initially set to 60 (decimal) minutes. 

/N Inhibits checking of creation dates of tape and 
disk files of same name when restoring from tape. 
Therefore, FAILSA restores a file from tape over 
the file of the same name on the disk without 
regard to creation date. This switch remains in 
effect until the line of input is terminated by a 
carriage return/line feed. 

/O Enables you to save and restore files to another 
user's area. This switch sets the destination 
project, programmer number to the specified 
number. The format is as follows: 

*/0 xxx, yyy <carriage return> 

This changes the single-user project-programmer 
number switch from that of the FAILSA user to 
xxx, yyy. The new value is retained until the next 
/O switch. If you do not issue this switch, your 
project, programmer number is used. 

/P Prints a directory of all files on the tape on 
logical device LST. The directory is listed by 
project-programmer number and includes the number 
of blocks allocated per file, a running total for 
each area, and creation time/access date 
information. If the logical device LST is 
assigned to the disk or a DECtape, the file name 
FAILSA. DIR is given to the directory file. 

/Q Disables the detailed progress reports given by 
FAILSA on a single-user restore. Complement of 
/T. This is assumed unless changed by a /T 
switch. 

/R Restores all files from the tape to the disk. 
This switch does not accept an argument because it 
transfers the entire tape. You must be logged in 
under [1,2] to use this feature. 

/S Saves disk files on the magnetic tape. Up to 16 
arguments can follow this switch, separated by 
spaces and/or tabs. These arguments are names of 
file structures or disk devices from which files 
are to be taken. If you specify no arguments, the 
system saves the entire disk; in this case, you 
must be logged in under [1,2]. 
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Switch Explanation 

/T Tells you, on a single-user restore, the user area 
that has been found on the tape, the file that has 
been selected for transfer to the disk, when the 
transfer is begun, and when the transfer is 
completed. An example of this progress report is 
shown below: 

LOCATED ON TAKE DSKC 27,235 
FOUND ON TAPE DSKC : FILNAME . EXT 
< > 

There may be a possible pause between the time the 
angle brackets are typed at the beginning and the 
end of transfer. The /T switch takes effect on 
the file for which it appears and ends when a /Q 
switch is given, 

/U Saves, on the magnetic tape, the disk files in the 
UFD of the user last named in a /G switch, or if 
no /G switch has been given, of whomever is 
currently logged in. Up to 16 arguments, 
separated by spaces and/or tabs, can follow this 
switch. These arguments are names of file 
structures or disk devices from which the files 
are to be taken, and, when used, only those 
structures mentioned that have files for the 
specified user are saved. If no arguments are 
given, all your files on all the structures are 
saved. You are informed if no files are saved 
from a specified structure. 

/V Generates a request to lock your job in core or 
resets the request. Note that locking may not be 
accomplished even though the request is given. 
FAILSA acknowledges if the lock is successful and 
does not acknowledge if the lock is unsuccessful. 
This switch is a toggle switch in the sense that 
its executions alternately set and reset a 
request. The operator can consult SYSTAT or 
SYSDPY to determine the state of the switch. 

/W Rewinds the magnetic tape with the logical name 
FAILSA to load point. 

/X Extracts the project-programmer numbers from the 
tape and reproduces output similar to the original 
TTY output generated by FAILSA during a save. The 
output contains the names and the 
project-programmer numbers on the tape. It is 
placed on logical device LST, and if LST is 
assigned to the disk or DECtape, the file name 
FAILSA. DIR is given to the output. 

/Y Debugs new features. 

/Z Debugs new features. 

/2 Sets the magnetic tape density to 200 bits/inch. 

/5 Sets the magnetic tape density to 556 bits/inch. 

/8 Sets the magnetic tape density to 800 bits/inch. 
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You can be selective as to the files you save or restore. Files 
are specified either explicitly by giving the file name and 
extension or implicitly by giving the wildcard construction. 

Characteristics 

The R FAILSA command: 

Places your terminal in user mode. 

Runs the FAILSA program, destroying your core image. 

Examples 

Saving your disk area 

♦ MOUNT HTA: /REEL IDt FAILSAFE ^ 

REQUEST QUEUED 

NO QPER. JOB FOR REQUESTS 

W A I T I NG . . . 2 "C ' S TO EX I T 

OPERATOR NOTIFIED 

WAITING. . ♦ 

FAILSAFE (MTAOOOJ) MOUNTED 



2C 
2£ 

* R FAILSAFE ^ 

REWINDS ARE NOT AUTOMATIC. 

FAILSAFE VERSION 10100*47* FOR HELP* READ SYS : FAILSA . HLPy OR TYPE /ll 

.10:47:50 22 JUNE 77 

TAPE * 01 6 9 CH BOO DPI 

NO FILES SAVED FOR 20*1547 DSKA 

DSKC 20*1547 

NO FILES SAVED FOR 20*. 1.547 

DSK DSKB 

*SAVE COMPLETED WITH TAPE # 01 

10 J 47: 57 22 JUNE 77 
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Function 

The FILCOM program is used to compare two versions of a file and 
to output any differences. Generally, this comparison is line by 
line for ASCII files or word by word for binary files. FILCOM 
determines the type of comparison to use by examining either the 
switches specified in the command string or the extensions of the 
files. Switches always take precedence over file extensions. 

Command Format 
.R FILCOM 

*output dev:file.ext [directory] = input dev (1) : f ile.ext [directory] 
input dev (2) : f ile. ext [directory] 

output dev: = the device on which the differences are to be 
output. 

input dev: = the device on which an input file resides. 

Defaults 

1. If the entire output specification is omitted, the output 
device is assumed to be TTY. However, the equal sign must be 
given to separate the input and output specifications of the 
command string. 

2. If an output file name is specified, the default output 
device is DSK. 

3. If the output file name is omitted, the second input file 
name is used, unless it is null. In this case, the file name 
FILCOM is used. 

4. If the output extension is omitted, .SCM is used on a source 
compare and .BCM is used on a binary compare. 

5. If the [directory] is omitted (input or output side), your 
default directory is assumed. 

6. If an input device is omitted, it is assumed to be DSK. 

7. If the file name and/or extension of the second input file is 
omitted, it is taken from the first input file. 

8. A dot following the file name of the second input is 
necessary to explicitly indicate a null extension, if the 
extension of the first input file is not null. For example, 
to compare FILE. MAC and FILE. (i.e., with null extension), 
use the following command string: 

.R FILCOM 
*=FILE. MAC, FILE. 

9. The second input file specification cannot be null unless a 
binary compare is being performed. In a binary compare, if 
the first input file is not followed by a comma and a second 
input file descriptor, the input file is compared to a zero 
file and is output in its entirety. This gives you a method 
of listing a binary file. (Refer to Example 4.) 
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The following switches can appear in the command string, 
depending on whether a source compare or a binary source compare 
is being performed. 

Switches Binary Compare 

/H Type list of switches available (help text from 
device HLP: ) . 

/nL Specify the lower limit for a partial binary 
compare (n is an octal number). This switch, when 
used with the /nU switch, allows a binary file to 
be compared only within the specified limits. 

/Q When the files are different, print the message 
?FILES ARE DIFFERENT, but do not list the 
differences. This switch is useful when batch 
control files want to test for differences but do 
not want the log file filled with these 
differences. 

/nU Specify the upper limit for a partial binary 
compare (n is an octal number). This switch, when 
used with the /nL switch, allows a binary file to 
be compared only within the specified limits. 

/W Compare files in binary mode without expanding the 
files first. (Refer to Appendix D.) This switch 
is used to compare two binary files with ASCII 
extensions. 

/X Expand SAV files before comparing them in binary 
mode. This action removes differences resulting 
from zero compression. (Refer to Appendix D.) 

Switches Source Compare 

/A Compare files in ASCII mode. This switch is used 
to force a source compare on two ASCII files. 

/B Compare blank lines. Without this switch, blank 
lines are ignored. 

/C Ignore comments (all text on a line following a 
semicolon) and spacing (spaces and tabs). This 
switch does not cause a line consisting entirely 
of a comment to become a blank line, which is 
normally ignored. 

/H Type list of switches available (help text from 
device HLP: ) . 

/nL Specify the number of lines that determine a match 
(n is an octal number). A match means that n 
successive lines in each input file have been 
found identical. When a match is found, all 
differences occurring before the match and after 
the previous match are output. In addition, the 
first line of the current match is output after 
the differences to aid in locating the place 
within each file at which the differences 
occurred. The default value for n is 3. 
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Switches Source Compare 

/Q Print the message 7FILES ARE DIFFERENT, when the 
files are different, but do not list the 
differences. 

/S Ignore spaces and tabs. 

/U Compare in update mode. This means that the 
output file consists of the second input file with 
vertical bars (or backslashes for 64-character 
printers) next to the lines that differ from the 
first input file. This feature is useful when 
updating a document because the changes made to 
the latest edition are flagged with change bars in 
the left margin. The latest edition of the 
document is the second input file. 

If switches are not specified in the command string, the files 
are compared in the mode implied by the extension. The following 
extensions are recognized as binary and cause a binary compare if 
one or both of the input files have one of the extensions. 

. BAC . HGH . RMT 

.BIN .LOW .RTB 

.BUG .MSB .SAV 

.CAL .OVR .SFD 

.CHN .QUE .SHR 

.DAE .QUF .SVE 

.DCR .REL .SYS 

.DMP .RIM .UFD 

.EXE .XPN 

Binary files are compared word by word, starting at word 0, 
except for the following three cases: 

1. Files with extensions .SHR and .HGH are assumed to be 
high-segment files. Because the word count starts at 400000, 
upper and lower limits, if used, must be greater than (or 
equal to in the case of the lower limit) 400000. 

2. Files with extensions .SAV, .LOW, and .SVE are assumed to be 
compressed core image files and are expanded before 
comparing. 

3. Files with the extension .EXE are assumed to be in .EXE 
program format. 

Conflicts are resolved by switches or defaults. If a conflict 
arises in the absence of switches, the files are assumed to be 
ordinary binary files. 

Output 

In most cases, headers consisting of the device, file name, 
extension, and creation date of each input file are listed before 
the differences are output. However, headers do not appear on 
output from the /U switch (update mode on source compare) . 
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Source compare output - After the headers are listed, the 
following notation appears in the left column of the output 

n)m 

where: 

n is the number of the input file, and 

m is the page number of the input file (see examples) 

The right column lists the differences occurring between matches 
in the input files. Following the list of differences, a line 
identical to each file is output for reference purposes. 

The output from the /U switch differs from the above-described 
output in that the output file created is the second input file 
with vertical bars in the left column next to the lines that are 
different from the first input file. 

Binary compare output - When a difference is encountered between 
the two input files, a line in the following format appears on 
the output device: 

octal loc. first file-word second file-word XOR of both 
words 

If the exclusive OR (XOR) of the two words differs only in the 

right half, the third word output is the absolute value of the 

difference of the two right halves. This usually indicates an 
address that changed. 

If one input file is shorter than the other, after the end of 
file is encountered on the shorter file, the remainder of the 
longer file is output. 

Characteristics 

The R FILCOM command: 

Places your terminal in user mode. 

Runs the FILCOM program, thereby destroying your core image. 

Examples 

1. You have the following two ASCII files on disk: 
♦ TYPE FILEA.RNQ -V 

A 

B 
C 
» 




R 
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♦ TYPE FILEB.RNO^ 



To compare the two files and output the differences on your 
terminal, the following sequence is used: 

♦ R FILCOM ^ Run the FILCOM program. 

ft =•• = F I L E A ♦ R N Q > F I L E B ♦ R N ^J Compare the two files on disk and 

output the differences on your 
terminal. By default, three 
consecutive identical lines 
determine a match. 
File 1 ) DSKCJFILEA.RN0C27»40723 crested: 0825 15-AUG-1977 
File 2) DSKC: FILED. RN0C27» 4072 J created: 0826 15-AUG-1977 



1)1 


D 


1) 


E 


1) 


F 


1 ) 


G 


*#*# 




2)1 


G 


%%%%%%%%%%%%%% 
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1) 
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1) 


N 


%%%% 
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2 


2) 


3 


2) 


N 


* * ** * ******* * * 


1 ) .t 


W 


.1. ) 


Z 


1) 


Y 


1) 


Z 


**** 




2 ) 1 


4 


2) 


13 


2) 


W 


2) 


X 


2) 


Y 


2) 


Z 



************** 



% f :i. I e <» 3 r e d :i. f f e r e n t 



To compare the two files and output the differences on the line 
printer, the following commands are used. Note that in this 
example the number of successive lines that determines a match 
has been set to four with the /4L switch. 



*/4L 



FILEA.F 



WQyFILEB.RNQ^ 



File 1) dskc: 
File 2) DSKC J 



'ILEA*RN0C27f40723 
ILEB.RN0C27»40723 



created* 
created* 



0825 
0826 



•AUG -.1.977 
-AUG- 1977 



i ) i 


D 




i) 


E 




i) 


F 




i) 


G 




**** 






2 ) :i. 


(3 




************** 




1)1 


K 




:l. ) 


L 




l) 


M 




.1. ) 


N 




**** 






2)1 


1 




2) 


2 




2) 


3 




2) 


N 




************** 




1 ) .1. 


W 




1) 


Z 




1) 


Y 




1) 


Z 




**** 






2)1 


4 




2) 


5 




2) 


W 




2) 


X 




2) 


Y 




2) 


Z 




<T' ^ ^ # #■ ^ # ^ ^T #■ # /ft /ft # 




%fil@s 


av& differei 


it 
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To compare the two files so that the second input file is output 
with vertical bars in the left column next to the lines that 
differ from the first input file, use the following command 
sequence. 

♦ R FILCOM ^ 

ft/U ■■■■■■■ F 1 1... E A * RNQ > F I LEB * RNQ *J 

A 

B 

C 
! G 

H 

I 

J 



% f :i. .'I. e s a r e d i f f e r e n t 
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2. To compare two binary files on 
differences on your terminal, 
sequence. 

*TTY : =DATESA ♦ REL r GETDAT ♦ REI...^ 



the disk and output the 
use the following command 



File 1) 


DSKCJDATESA.REI.. 


.C 27* 407; 


>1 


created. 1456 17- 


•MAY "1977 


File 2) 


DSKCJGE 


£ TD AT. REL C 27*4072 3 


created? 1333 08- 


•JUNE- 1977 


000002 


000213 


455765 


0.1.5212 


412526 


015001 


047243 




000005 


000213 


455765 


015212 


412526 


01500.1 


047243 




00001.1 


000000 


001507 


000000 


003172 




001463 




000013 


000001 


100300 


000002 


400015 


000003 


500315 




000014 


410000 


000000 


414343 


456064 


004343 


456064 




000015 


000001 


100307 


324156 


630000 


324157 


730307 




000016 


420000 


000000 


000003 


400055 


420003 


400055 




000017 


000002 


100217 


444164 


453246 


444166 


553051 




000020 


425164 


326045 


625755 


326165 


200631 


000120 




00002.1. 


623263 


454300 


416264 


456263 


235007 


002163 




000022 


000001 


100316 


000002 


400041 


000003 


500357 




000023 


430000 


000000 


444171 


324445 


074171 


324445 




000024 


000002 


100343 


435744 


450000 


435746 


550343 




000025 


435756 


664441 


000001 


100161 


435757 


764520 




000026 


644500 


000000 


444171 


630000 


200471 


630000 




000027 


000001 


100325 


000001 


100300 




000025 




000030 


440000 


000000 


444554 


322100 


004554 


322100 




000031 


000003 


400011 


00000.1. 


100026 


000002 


500037 




000032 


444164 


453263 


446555 


444171 


002431 


017312 




000035 


000000 


001530 


000000 


003213 




001463 




000036 


555164 


503256 


000002 


100226 


555166 


403070 




000037 


655500 


000000 


446555 


557132 


213055 


557132 




000040 


000001 


100370 


444164 


450000 


444.1.65 


550370 




000041 


444171 


000000 


000003 


400045 


444172 


400045 




000042 


000001 


100161 


455644 


324441 


455645 


224520 




000043 


444171 


644142 


713244 


454357 


357335 


210215 




000044 


000002 


400041 


444500 


000000 


444502 


400041 




000045 


446356 


324570 


000002 


400021 


446354 


724551 




000046 


516400 


000000 


465162 


636432 


173562 


636432 




000047 


000002 


100433 


455664 


627100 


455666 


727533 




000050 


466257 


553264 


000002 


100352 


466255 


453136 




000051 


716045 


000000 


544541 


603246 


252504 


603246 




000052 


000001 


400015 


544 1"0 










%f i les 


are difl 


'erent 
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3. To compare two high-segment files, the command sequence below 
is used. Note that the locations begin at 400000. 

♦ R FILCOM^ 



*TTY I apAT ♦ SHR r XMH ♦ SHR^ 










F i 1 e 1 ) 


DSKCJPAT.SHRCS 


\7\ 


.40723 


created 


: 0000 23-JAN-1976 


File 2) 


DSKCJXMH.SHRC5 


\7\ 


> 40723 


created 


t 0836 : 


28 -AUG- -1976 


400000 


035064 417316 




001754 


400010 


034730 


017306 


400002 


035063 035777 




000137 


001777 


035154 


034000 


400003 


017532 000000 




003161 


000000 


014453 


000000 


400004 


000000 000000 




000201 


000000 


000201 


000000 


400005 


604164 000000 




705550 


000000 


101434 


000000 


400007 


000000 000000 




000400 


000000 


000400 


000000 


400010 


051140 401256 




254040 


4000.1.1 


205100 


001247 


400011 


254000 400027 




047000 


000000 


213000 


400027 


400012 


274640 000002 




334740 


4000.1 3"0 






Zfiles 


are different 
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4. To list a binary file, use the following command sequence. 
*~C 



* TTY:«XMH«SHR ^y 

400000 001754 400010 

400001 254200 000000 

400002 000137 001777 

400003 003161 000000 

400004 000201 000000 

400005 705550 000000 

400006 000000 000000 

400007 000400 000000 

400010 254040 400011 

400011 047000 000000 

400012 334740 400013 

400013 776422 000140 

400014 200640 000017 

400015 201600 000000 

400016 201700 401533 

400017 201700 401533 

400020 260740 402314 

400021 265040 402756 

400022 000041 000041 

400023 555757 505460 

400024 201040 000001 

400025 201100 020321 

400026 505100 425453 

400027 260740 402323 

400030 202055 000002 

400031 201040 000001 

400032 201100 020321 

400033 505100 425453 

400034 260740 402323 

400035 202055 000001 

400036 200455 000001 

400037 505440 441200 

400040 402015 000005 

400041 201040 000001 

400042 202055 00"0 
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To compare two binary files between locations 
(octal) . 



5. 



150-160 



* T T Y t/1 501-/160U-DATESA » REL t GETDAT ♦ R E L ^J 



File 1) 


DSKCJDATESA.REL 


C27»407: 


13 


createc 


j: 1456 


17-MAY-1977 


File 2) 


DSKC J GETDAT* REL 


i:: 27 1 407: 


>.l 


create*. 


It .1.333 


08- JUNE- 1977 


COO 150 


416200 000000 


620000 


000000 


236200 


000000 




000151 


000001 400045 


000001 


100262 




277563 




000152 


636544 416445 


675762 


533221 


043226 


125664 




000155 


000000 001634 


000000 


003317 




001463 




000156 


000002 400051 


000002 


100325 




277524 




000.1.57 


636544 416445 


675762 


533241 


043226 


125604 




000160 


324570 516400 


566300 


000000 


642670 


5.1.6400 




% files 


are different 
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Function 

The FILE command provides remote control of DECtape-to-disk and 
disk-to-DECtape transfers on operator-handled DECtapes. 

Command Formats 

1. FILE C 

Checks the queue of FILE requests to determine if any of your 
requests are still pending. No argument is required. 
Pending requests for your job will be listed. 

2. FILE D, id, file.ext, file.ext, ... 

Deletes the specified files from DECtape. Requires tape-ID 
and list of file names as arguments. The tape-ID is a 1- to 
6-character alphanumeric name that is used to identify the 
tape. After the files are deleted, an automatic FILE L is 
performed. 

3. FILE F, tape-ID, dev: file.ext [proj , prog] ,dev: file.ext [proj , prog] 

Files information onto a DECtape. Requires tape-ID and list 
of file specifications as arguments. The file specifications 
may include an explicit file structure name and project, 
programmer number so that you can copy files from a disk area 
other than your own. The device and project, programmer 
number need not be specified for subsequent file 
specifications if they do not change. That is, only the 
programmer number (e.g., [,104]) need be specified if the 
file to be copied has the same project number as yours and 
only the project number [41,] need be specified if you have 
files from another project that you wish to copy. The 
protection of the disk file is checked to see if the file can 
be read. In addition, the protection of the DECtape 
directory file (tape-ID. DIR) is checked to see if it can be 
updated. If there is not enough room on the DECtape to copy 
an entire file, that portion (if any) that has been written 
so far is deleted and an error message is placed in the 
directory file. When the files have been copied, an 
automatic FILE L is performed. 

4. FILE L, id 

Reads the directory of a DECtape and places it in your disk 
area as an ASCII file with the file name tape-ID. DIR. The 
file is placed on the first writable file structure in your 
search list provided that that structure contains your UFD. 
Tape-ID is a 1- to 6-character alphanumeric name that is used 
to identify the tape. It is the only argument. You may then 
print the directory with a monitor command. The format of 
the DECtape directory is similar to the directory file 
written by the monitor command DIRECT. If errors occur while 
the FILE command is being processed, error messages are 
written into the directory file tape-ID. DIR. 

5. File R, tape-ID, dev: file.ext, dev: file.ext. . . 

Retrieves (transfers) information from your DECtape to the 
disk. Requires tape-ID and list of file names as arguments. 
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If the specified files already exist, they are superseded 
only if their protection allows it. If the specified files 
do not exist, they are created on the first file structure in 
your job's search list for which creation is permitted. 
After files are transferred, an automatic FILE L is 
performed. 

6. FILE W 

Waits until all of your pending requests are processed before 
allowing your job to continue. If there are pending 
requests, the message "Waiting... Type 2 "C's to Exit" is 
typed to you. Control returns when all requests have been 
processed. You may type two CTRL/Cs (~C~C) if you decide not 
to wait. 

7. FILE Z, TAPE-ID, dev:file. ext [ppn] ,dev:file.ext [ppn] .. . 

Zeroes the directory of the DECtape before the files are 

copied and then performs the same operations as the FILE F 

command. Requires tape-ID and may have a list of directory 

specifications arguments. After the files are copied, an 
automatic FILE L is performed. 

The C and W functions are the only requests that are performed 
whenever possible. Your terminal and job are free to proceed 
before the request is completed except for batch jobs, which 
always wait. The function argument is optional. If the function 
argument is not specified, a brief dialogue is performed. 

In most cases you do not need to specify which file structures 
the files are on because UMOUNT determines this (with LOOKUPs) 
and passes the information to OMOUNT. With the FILE F and FILE Z 
functions, if a file structure is not specified and the named 
file exists on more than one structure, the first one in your 
search list is copied. For the FILE R function, when no file 
structure is specified, the files are copied onto the first file 
structure in your search list on which you are allowed to create 
files. (Refer to the description of the SETSRC program.) When a 
file structure name is typed or implied, it becomes the new 
default. 

The wildcard (*) and wild-character (?) constructions may be 
used, but care should be taken when generic DSK: is typed (or 
implied) for FILE R commands. Because DSK: may define many file 
structures, the single file structure is chosen as follows: 

When the wildcard or wild-character . construction is used for the 

file name or extension, the first structure in your search list 

on which you may create files and has a UFD is used. This is 
called your standard file structure. 

If the wildcard or wild-character construction is not used and 
the file exists, the first file structure in the search list then 
contains the specified file is used, unless overridden by a 
default. (See Examples.) If the file does not exist, the 
standard structure is used. 
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WARNING 

If you have a search list with multiple 
file structures, the asterisk 
construction (when used with the FILE R 
command) can cause files to be created, 
rather than superseded. 

When the wild or wild-character construction is used with the 
FILE F and FILE Z commands, your job's entire search list is 
used. That is, all files matching the wild construction are 
transferred from all structures in the search list. 

A project, programmer number (either explicit or implicit) may 
only be specified in file descriptors for the FILE F and FILE Z 
commands. 

In the examples below, your search list is as follows: 

SORT:, DSKA: /NOCREATE , DSKB:, DSKB:, DSKC: 

You have UFDs on DSKA, DSKB, and DSKC, and the file EX.1 exists 
on each of these three structures. User 10,4072 has the file 
EX.2 in that area on DSKB and on DSKC. 

♦ FILE F f TAPE! y EX . 1 r EX ♦ 2C 10 r 40723 ^7 
REQUEST QUEUED 

1. F J0B30 TTY111 10>4072 TAPE1 DSKBJ s-DSKAOJEX. 1 >DSKB0: 

EX. 21:10? 4072 3 

1 COMMAND IN QUEUE 

This command requests that the DECtape TAPE1 be mounted, that the 
file EX.1 in your area be copied onto it, that the file 
EX.2 [10,4072] also be copied onto the DECtape, that a directory 
of the DECtape be written in your area, and that the DECtape then 
be dismounted. 

The directory is written on the first structure encountered in 
the search list which is both writable and on which you have a 
UFD. In the above example, you do not have a UFD on the first 
structure in your search list (SORT) , you cannot create new files 
on the second structure in your search list (DSKA) and so, the 
directory is written on the third structure in your search list 
(DSKB) . 

The file EX.1 on DSKA only will be copied onto the DECtape 
because the copy on DSKA was encountered first. The file 
DSKB.-EX. 2 [10,4072] will be copied onto the DECtape because the 
copy on DSKB was encountered first. 

♦ FILE F 9 TAPE2 , DSKC : EX ♦ 1 , C t 40723EX .2 ^7 
REQUEST QUEUED 

2. F JOB30 TTY111 .1.0*4072 TAPE2 DSKB J t DSKCO * - 

EX . 1 » DSKCO J EX . 2i: 10 r 40723 

2 COMMANDS IN QUEUE 
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In this example, you specified the explicit device DSKC for 
copying from both area. DSKC was typed only once because a 
device given in a file specification remains in effect for 
subsequent file specifications unless another device is 
specified. Note the omission of the project number in the 
command string. Also note that the p,pn can be specified either 
before the file name (as in this example) or after the file name 
(as in the preceding example) . 

. FILE C -J 

It F J0B30 TTY111 10*4072 TAPE! DSKBtDSKAO JEX . 1 t 
DSKBO I EX * 2 C 10 , 40723 

2 . F J0B30 IT Y 1 1 1 10 r 4072 T APE2 DSKB t r DSKCO t EX . 1 , 
DSKCO : EX *2C 10*40723 

2 COMMANDS IN QUEUE 

» 
The response from the FILE C command indicates to you which of 
your requests have not yet been processed. In this case, both of 
your requests are still pending. 

♦ FILE RrTAPEl vEX.t ^J 

REQUEST QUEUED 

!♦ R J0B24 TTYlll 10*4072 TAPE! DSKB t y DSKB SEX ♦ 1 

1 COMMAND IN QUEUE 
* 

The FILE R command uses the same algorithm as the FILE F (and Z) 
command for determining the device on which to write the 
directory. The file EX.1 is written on the first writable file 
structure in your search list. Note that the file EX.1 already 
exists on DSKA, DSKB, and DSKC. DSKA is NOCREATE, so the file 
EX.1 is written onto DSKB, superseding the EX.1 already on DSKB. 

. FILE F y TAPE3yE?,ft ^ 

REQUEST QUEUED 

2* F J0B24 TTYlll 10*4072 TAPE3 DSKB? SORTJE?.** 

DSKA * E'i\ # ? DSKB t E'i\ # * 
DSKCJE?.* 

2 COMMANDS IN QUEUE 
■> 

In cases where a wild-character and/or wildcard construction is 
used, UMOUNT uses the entire search list to determine what files 
to copy for FILE F and FILE Z commands; whether or not you have 
a UFD on a particular structure. UMOUNT passes the wild 
construction, along with each structure in the search list, to 
OMOUNT. 
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Function 

The FILEX program is a general file transfer program used to 
convert between various core image formats, and to read and write 
various DECtape formats. Files are transferred as 36-bit data. 
The only processing on the data is that necessary to convert 
between various core image representations. 

Command Format 
.R FILEX 

*dev:of ile.ext [directory] <nnn>/switches = dev: 
f ile.ext [directory]/switches 

If the project-programmer and/or the switches appear after 
the device name, they apply to all the following files. If 
they appear after the file name, the specifiers apply only 
to the preceding file. The input file name or extension may 
be *, in which case the usual processing of the *, 
construction occurs. (Refer to the TYPE command.) The 
output file name and extension may be *, in which case the 
file name and extension of the input file is copied. If the 
output file name or extension is missing, the same procedure 
occurs as with the * construction, except that all core 
image files are written with the default extension and 
format appropriate to the output device (unless overridden 
by switches) . 

If a protection <nnn> is not specified, files are written 
with the system standard protection unless the files are 
being written on SYS. On SYS, files are written with 
protection <155>, except for files with extension .SYS. 
These files have the default protection of <157>. 

Meaning of Switches: 

Help text 

/H to obtain an explanation of the command string and 
individual switches. 

DECtape Format Specifiers 

/F PDP-15 DECtape format 

/M MIT project MAC PDP-6/10 DECtape format 

/0 Old DEC PDP-6 DECtape format 

/T Normal PDP-10 directory format 

/V PDP-11 DECtape format. 

File Format Specifiers 

/A ASCII processing; meaningful only for PDP-11 and 
PDP-15 tapes. 

/B binary processing; overrides default extension. 
Files read from a PDP-11 format tape with this 
switch contain four 8-bit bytes in each 36-bit 
word (1st byte in bits 10-17, 2nd byte in bits 
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2-9, 3rd byte in bits 28-35, and 4th byte in bits 

20-27) . Files written on a PDP-11 format tape 

with this switch are assumed to have the same 
format. 

/C compressed; save file format. This format is 
assumed for files with extensions .SAV, .LOW, 
.SVE. The default output extension is .SAV unless 
the input extension is .LOW or .SVE, in which case 
the extension remains unchanged. 

/D dump format. This format is assumed for files 
with extension .DMP. 

/E expanded core image files (used by FILDDT) . This 
format is assumed for files with extension .XPN. 
The default output extension is .XPN. 

/I image processing; meaningful only for PDP-11 and 
PDP-15 tapes. 

/S simple block (SBLK) format, project MAC ' s 
equivalent of .SAV format. The default output 
extension is .BIN. 

DECtape Processing Specifiers 

/G (go on) , ignores read errors on input device. 
FILEX checks the always-bad-checksum bit in the 
5-series monitor, so this switch is not needed for 
files with .RPABC on (e.g., CRASH. SAV). 

/L (list) , causes a directory on an input DECtape 
file to be typed on your terminal or causes a 
directory listing of the output DECtape at the end 
(i.e., after the output). 

/P (preserved) , causes quick processing (/Q) and 
preserves the scratch file after processing for 
use by another command. 

/Q (quick) , causes an input or output DECtape to be 
processed quickly by creating a scratch file on 
the disk. This file is deleted after processing 
is completed. 

/R (reuse) , reuses a scratch file preserved by a /P 
in a previous command. 

/Z (zero) , causes the appropriate format of a zeroed 
directory to be written on a DECtape output file. 
(Zeroing a DECtape directory is equivalent to 
deleting all the files on the tape.) If TAPEID 
appears in the output specifier, then TAPEID is 
written as the tape identifier in the directory. 
TAPEID is preceded by a circumflex (~) and may be 
6 characters on a DECsystem-10 tape, 3 characters 
on a project MAC tape, and is not present on a 
PDP-6 tape. 



Characteristics 

The R FILEX command: 



Runs the FILEX program, thereby destroying your core image. 
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Examples 



* R FILEX ^ The dump format file is compressed and 

written as TEST.SAV. 

*DSK I ="IiA\A\TAl 10 : TEST ♦ DMP/C *J 



. R FILEX ^ Copy CRASH. SAV to an expanded format 

file for FILDDT to examine. 

*DSK % SERO 1 5 ♦ XPN C 1 > 1 3 «DSKC X CRASH ♦ SAU I!.' 1 r A l^J 
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Function 

The FINISH command terminates any input or output currently in 
progress on the specified device and automatically performs the 
RELEASE UUO (which CLOSES the files) and DEASSIGN command, thus 
making the device available to another user. This command is 
preferred over the DEASSIGN command because it completely 
disassociates an INITed device from your job, thereby preventing 
you from continuing your program. If you wish to continue your 
program, you should use the DEASSIGN command. 

Command Format 

FINISH dev 

dev is the logical or physical name of the device on which 
I/O is to be terminated. This argument is optional. 

If dev is omitted, I/O is terminated on all devices, except 
your job's controlling terminal and the logical name of the 
controlling terminal is cleared. 

Characteristics 

The FINISH command: 

Leaves your terminal in monitor mode. 
Requires core. 

Restrictions 

You cannot continue your program if the device was INITed, but 
you can start at the beginning or enter DDT. 

Examples 

♦ finish cmt^J 



♦ FINISH DTAQ17?^ 



♦ FINISH lpt:^ 
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Function 

The FUDGE command creates a library REL file from a temporary 
file generated by a previous COMPILE, LOAD, EXECUTE, or DEBUG 
command string containing the /FUDGE switch. The library is 
created with the REL files in the same order in which they were 
specified in the command string. (Refer to the MAKLIB program 
writeup and to LOADER and LINK-10 documentation for descriptions 
of library REL files.) 

NOTE 

Because the COMPIL program sorts out 
files by compilers, mixed FORTRAN and 
MACRO programs are sorted so that all 
FORTRAN programs are compiled first and 
MACRO programs second. However, the 
/FUDGE switch combines them in the order 
in which the COMPIL program encountered 
them. 

When the /FUDGE switch is used, you must issue the FUDGE command 
before issuing any other COMPIL-class command that runs PIP 
(e.g., TYPE, COPY). The reason for this is that there is only 
one temporary file containing information generated by 
COMPIL-class commands that run PIP. Therefore, the information 
generated by the /FUDGE switch will be superseded by the 
information generated by any other COMPIL-class command which 
runs PIP. By issuing the FUDGE command, the library REL file can 
be generated before the contents of the temporary file are 
overwritten by another COMPIL-class command. 

Command Format 

FUDGE 

Characteristics 

The FUDGE command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, thereby destroying your core image. 

Examples 

* COMPILE /FUDGE t LIBRARY/MACRO TEST ♦ MAT ? DATAPRQ » CBL r SCIENCE « FA ^J 

♦ FUDGED 

Create a disk file named LIBRAR that contains the names of 
all the REL files produced. 

Create the library file and call it LIBRAR. This file 
contains the following: TEST. REL, MATH. REL, DATPRO.REL, and 
SCIENC.REL. 



This command runs the COMPIL program, which interprets the command 
before running the PIP program. 
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Function 

The GET command loads a core image from a retrievable storage 
device but does not begin execution. 

This command clears all of your core. However, programs should 
not count on this action and should explicitly clear those areas 
of core that are expected to contain zeros (i.e., programs should 
be self-initializing) . This action allows programs to be 
restarted by a "C , start sequence without having to do another 
GET command. 

On magnetic tape, if the low or high segment is missing, a null 

record is output before the EOF for the missing segment so that 

two EOFs cannot occur consecutively. Therefore, a saved null 
segment does not appear as a logical EOT (2 EOFs in a row) . 

Command Format 

GET dev: file. ext [proj , prog] core 

The arguments and the defaults are the same as in the RUN 
command. 

Characteristics 

The GET command: 

Leaves your terminal in monitor mode. 

Does not operate when the device is currently transmitting 

data. 



Example 



♦ GET SYS i PIP *J 
JOB SETUP 



♦ GET TEST ^J 
JOB SETUP 
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Function 

The GLOB program reads multiple binary program files and produces 
an alphabetical cross-referenced list of all the global symbols 
(symbols accessible to other programs) encountered. This program 
also searches files in library search mode, checking for globals, 
if the program file was loaded by the LOADER in library search 
mode. (Refer to the LOADER documentation.) 

The GLOB program has two phases of operation: the first phase is 
to scan the input files and build an internal symbol table, and 
the second, to produce output based on the symbol table. Because 
of these phases, you can input commands to GLOB in one of two 
ways. The first way is to specify one command string containing 
both the output and input specifications. (This is the command 
string format most system programs accept.) The second is to 
separate the command string into a series of input commands and 
output commands. 

Command Formats 

1. R GLOB 

outputdev: file. ext [directory] = input dev: file. ext [directory] , 
f ile. ext, ... ,dev: file. ext [directory] $ 

2. R GLOB 

followed by one or more input commands in the form 

dev: file. ext [directory] , f ile. ext [directory] , . . . , 
dev: file. ext [directory] , . . . 

and then one or more output commands in the form 

outdev: file. ext [directory] = $ 

When you separate your input to GLOB into input commands and 
output commands (Command Format #2) , the input commands contain 
only input specifications and the output commands, only output 
specifications. Each output command causes a listing to be 
generated; any number of listings can be printed from the symbol 
table generated from the current input files as long as no input 
commands occur after the first output command. When an input 
command is encountered after output has been generated, the 
current symbol table is destroyed and a new one begun. 

Defaults 

1. If the device is omitted, it is assumed to be DSK. However, 
if the entire output specification is omitted, the output 
device is TTY. 

2. If the output file name is omitted, it is the name of the 
last input file on the line (Command Format #1) or is GLOB if 
the line contains only output commands (Command Format #2) . 
The input file names are required. 
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3. If the output extension is omitted, .GLB is used. If the 
input extension is omitted, it is assumed to be .REL unless 
the null extension is explicitly specified by a dot following 
the file name. 

4. If the project-programmer number [proj,prog] is omitted, your 
default directory is used. 

5. An ALTmode terminates the command input and signals GLOB to 
output the cross-referenced listing. In other words, a 
listing is not output until GLOB encounters an ALTmode. The 
ALTmode appears at the end of the command string shown in 
Command Format #1 or at the end of each output command shown 
in Command Format #2. 

Switches 

Switches control the types of global listings to be output. Each 
switch can be preceded by a slash, or several switches can be 
enclosed in parentheses. Only the most recently specified switch 
(except for L, M, P, Q, and X, which are always in effect) is in 
effect at any given time. If no switches are specified, all 
global symbols are output. The following switches are available. 

/A Output all global symbols. This is the default if no 
switches are specified. 

/E List only erroneous (multiply defined or undefined) 
symbols. 

/F List nonrelocatable (fixed) symbols only. 

/H List the switches available (help text) from 
HLP:GLOB:HLP. 

/L Scan programs only if they contain globals previously 
defined and not yet satisfied (library search mode) . 

/M Turn off library search mode scanning resulting from a 
/L switch. 

/N List only symbols which are never referenced. 

/P List all routines that define a symbol to have the same 
value. The routine that defines the symbol first is 
listed, followed by a plus (+) sign. Subsequent 
routines that define the symbol are listed, preceded by 
a plus sign. 

/Q Suppress the listing of subsequent definers that result 
from the /P switch. 

/R List only relocatable symbols. 

/S List symbols with non-conflicting values that are 
defined in more than one program. 

/X Do not print listing header when output device is not 
your terminal, and include listing header when it is 
your terminal. Without this switch, the header is 
printed on all devices except your terminal. The 
listing header is in the following format: 

flags symbol octal value defined in referenced in 
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Symbols listed are in alphabetical order according to 
their ASCII code values. The octal value is followed 
by a prime (') if the symbol is relocatable. The value 
is then relative to the beginning of the program in 
which the symbol is defined. Flags preceding the 
symbol are shown below. 

M Multiply defined symbol (all values are 
shown) . 

N Never referred to (i.e., was not declared 
external in any of the binary programs) . 

S Multiply specified symbol (i.e., defined in 
more than one program but with 
non-conflicting values) . The name of the 
first program in which the symbol encountered 
is followed by a plus sign. 



Undefined symbol 



Characteristics 

The R GLOB command: 



Places your terminal in user mode. 

Runs the GLOB program, destroying your core image. 



Examples 

* R GLOB *J 

% I... 1 "■ T X = M A I N ♦ D TAP 1 2 % S U B 4 ♦ S U B 5 00 
<ESC> 



Run the GLOB program. 

All global symbols in the program 

MAIN (on DSK), SUB40, and SUB50 (on 

DTA2) are listed on the line 
printer. Along with the symbol is 
listed its value, the program in 
which it is defined, all programs 
in which it is referenced, and any 
error flags. 

>K DTAQ:l. 4 : BATCH ♦ REL , DTA > DTA006 : NUMBER ♦ REL > CLASS *J 

* DSK : HATH ♦ REL r LIBRARY *J 

The programs to be scanned are 
BATCH. REL, DATA. REL on DTA4 ; 
NUMBER. REL, CLASS. REL on DTA6; and 
MATH. REL, LIBRARY. null on DSK. 



*LPT:~/F4 <ESC> 



*bsk:symbol.«/r<esc 



* tty:-/e <esc> 
u extsym subtre 



List only nonrelocatable symbols on 
the line printer. 

List only relocatable symbols in 
the file named SYMBOL in your 
default directory. 

Print all erroneous symbols on the 
terminal. EXTSYM is an undefined 
symbol appearing in the program 
SUBRTE . 



*"C 



Return to monitor mode. 
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Function 

The GRIPE program accepts text from you and records it in a disk 
file, thereby enabling other users to record comments and 
complaints to be read at a later time by the operations staff. 

Command Format 
R GRIPE 

When the GRIPE program responds with a YES?, type the text, 
using as many lines as necessary, terminated with an ESCAPE. 
The text is written as a file with <157> protection and 
includes a header with the date, time, and your 
project-programmer number. Therefore, you do not need to 
identify yourself. 

Characteristics 

The R GRIPE command: 

Places your terminal in user mode. 

Runs the GRIPE program, thereby destroying your core image. 

Example 

♦ R GRIPE ^ 

Yes? (Depress ESCape key when through) 

THIS CONSOLE IS ALMOST OUT OF PAPER AND IT NEEDS A NEW RIBBON, ^ 

THANK YOU 
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Function 

The HALT (~C) command transmits a HALT command to the monitor 
command interpreter. It stops your job and stores the program 
counter in the job data area (.JBPC). CTRL/C, unlike HALT, can 
be issued at user level. (Refer to the DECsystem-10 Monitor 
Calls for a description of the job data area.) 

Command Format 
HALT (~C) 

Characteristics 

The HALT ("O command: 

Places the terminal in monitor mode. 
Does not require LOGIN. 



Example 
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Function 

The HELP command is used to obtain useful information on various 
system features. You can select this information from the 
following special disk devices: HLP:, NEW:, OLD:, and SYS:. 

Command Formats 

1. HELP 

Outputs the instructions for receiving information. 

2. HELP dev:* 

Outputs both the names of features that have available 
documentation contained on the specified device and the names 
of monitor commands, including the SET commands. 

3. HELP dev: name 

Outputs the information on the named feature contained on the 
specified device. 

Only the first six characters of the name argument are scanned. 
These characters must be A through Z, through 9, or asterisk 
(*). 

If the requested file is not found on the specified device, or if 
the device argument is omitted, the devices are searched in the 
following order: HLP:, SYS:, NEW:, and OLD:. However, if you 
have device NEW: enabled in this search list (refer to the 
SETSRC program writeup) when using Command Format #3, it is 
searched before device SYS:. Both logical and physical names are 
searched for each device. 

Characteristics 

The HELP command: 



Leaves your terminal in monitor mode, 
Does not require LOGIN. 



Examples 

.HELP %J 



HELP is 


aval. lab 


il© for ti 


he following* 








ALCOMP 


ALLOT 


ALQUIK 


APL 


BACKUP 


BASIC 


BATCH 


BLIS10 


BLKTRN 


BLS36C 


BOOTH 


BOGTGT 


BOX 


CDPSPL 


CDRSTK 


CHANGE 


COBDDT 


COBOL 


COBRG 


COPYED 


CPL 


CREDIR 


CREF 


CSGRT 


CSP10 


DBMEND 


DC72 


DC76 


DDT 


DELFIL 


DIRECT 


DISMOU 


DSKRAT 


DTADIR 


DTELDR 


ERSATZ 


FAILSA 


FGEN 


FILCOM 


FILDAE 


FILE 


FILEX 


FIND 


FNDBLD 


FORDDT 


FORDML 


FORTRA 


FRS 


FUDGE2 


GALAXY 


GALNEW 


GASP 


GLOB 


GRIPE 


HELP 


HERMES 


HYPHEN 


INI 


INITIA 


ISAM 


JQ 


KILL 


LDVT20 


LIBARY 


LINED 


LINK 


LOGIN 


LOGOUT 


LPTSPD 


LPTSPL 


MACRO 


MAC Y. 11 


MAIL 


MAKLIB 


MAKVFU 


MATCH 


MATHLA 


MCSGEN 


MIMIC 


MQDUNV 


MOUNT 


MTCOPY 


NETLDR 


NETOPR 


OLD 


GMOUNT 


OPSER 


PIP 


PLEASE 


PLTSPL 


PMAKER 


PPNLST 


PTPSPL 


QDMP 


QDUMP 


QUEUE 


GUOLST 


REDUCE 


RERUN 


REV 


RSXFMT 


RUNINP 


RUNOFF 


SAFE 10 


SCDCP 


SENGEN 


SETSRC 


SIMCOM 


SIMDDT 


SIMDIR 


SIMRTS 


SIMULA 


SORT 


SORTC 


SOS 


SOUP 


SPACE 


SPELL 


SPRINT 


SPROUT 


SPY 


SUBNEW 


SUBSYS 


SY 


SYSDPY 


SYSERR 


SYSTAT 


TAPE 


TECO 


TECOH 


TRACK 


TTT3D 


TTYTST 


UFDREN 


UMOUNT 


WHEEL 


XTEN 


.1.984 
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The in on 


iltor has 


the following commands* 








ACCOUN 


ALL OCA 


ASSIGN 


ATTACH 


BACKSP 


BACKTO 


CCONTI 


CLOSE 


CO JOB 


COMPIL 


CONTIN 


COPY 


CORE 


CRUNCH 


CREATE 


CREF 


CSHIFT 


CSTART 


CTEST 


D 


DAYTIM 


DCORE 


DDT 


DEASSI 


DEBUG 


DELETE 


DETACH 


DIRECT 


DISMOU 


DO 


DSK 


DUMP 


E 


EDIT 


EOF 


ERROR- 


EXECUT 


FILE 


FINISH 


FREE 


FUDGE 


GET 


GOTO 


HALT 


HELP 


I 


IF 


INITIA 


JCONTI 


KJOB 


LABEL 


LET 


LIST 


LOAD 


LOCATE 


LOGIN 


MAKE 


MIC 


MOUNT 


NODE 


NOERRO 


NOOPER 


NSAVE 


NSSAVE 


ON 


OPERAT 


OSAVE 


OSSAVE 


PJOB 


PLEASE 


PLOT 


PRESER 


PRINT 


PROTEC 


PUNCH 


QUEUE 


R 


RE ASS I 


REENTE 


RENAME 


RES OUR 


REVIVE 


REWIND 


RUN 


SAVE 


SCHEDU 


SEND 


SESSIO 


SET 


SILENC 


SKIP 


SOS 


SSAVE 


START 


SUBMIT 


SYSTAT 


TECO 


TIME 


TPUNCH 


TTY 


TYPE 


UNLOAD 


USESTA 


VERSIO 


WHENEV 


WHERE 


XCHNGE 


ZERO 










The monitor has 


the following SET commai 


•ids I 






BLOCKS 


BREAK 


CDR 


CORMAX 


CORMIN 


CPU 


CTEST 


DATE 


DAYTIM 


DEFAUL 


DEFER 


DENS IT 


DSKFUL 


DSKPRI 


HOSTES 


HPQ 


MEMORY 


NODEFE 


NOMESS 


OPR 


PHYSIC 


RETRY 


SCHEDU 


SPOOL 


TIME 


TTY 


VIRTUA 


VMMAX 


WATCH 









T h e nri o n :i t o r has 
ALTMOD BLANKS 
FORM GAG 
SLAVE SPEED 



the following I 
COPY CRLF 
HOLD IGNORE 
TABS TAPE 



!ET TTY commands* 

DEBREA ECHO ELEMEN 

LC NO PAGE 

TIDY UC WIDTH 



FILL 
RTCOMP 



The monitor has the following SET WATCH commands* 

DAY MTA READS RUN VERSIO WAIT WRITES 



HELP NEW!*^ 



The mon 


liter has 


the following commands* 








ACCOUN 


ALLOCA 


ASSIGN 


ATTACH 


BACKSP 


BACKTO 


CCONTI 


CLOSE 


COJOB 


COMPIL 


CONTIN 


COPY 


CORE 


CRUNCH 


CREATE 


CREF 


CSHIFT 


CSTART 


CTEST 


D 


DAYTIM 


DCORE 


DDT 


DEASSI 


DEBUG 


DELETE 


DETACH 


DIRECT 


DISMOU 


DO 


DSK 


DUMP 


E 


EDIT 


EOF 


ERROR- 


EXECUT 


FILE 


FINISH 


FREE 


FUDGE 


GET 


GOTO 


HALT 


HELP 


I 


IF 


INITIA 


JCONTI 


KJOB 


LABEL 


LET 


LIST 


LOAD 


LOCATE 


LOGIN 


MAKE 


MIC 


MOUNT 


NODE 


NOERRO 


NOOPER 


NSAVE 


NSSAVE 


ON 


OPERAT 


OSAVE 


OSSAVE 


PJOB 


PLEASE 


PLOT 


PRESER 


PRINT 


PROTEC 


PUNCH 


QUEUE 


R 


RE ASS I 


REENTE 


RENAME 


RESOUR 


REVIVE 


REWIND 


RUN 


SAVE 


SCHEDU 


SEND 


SESSIO 


SET 


SILENC 


SKIP 


SOS 


SSAVE 


START 


SUBMIT 


SYSTAT 


TECO 


TIME 


TPUNCH 


TTY 


TYPE 


UNLOAD 


USESTA 


VERSIO 


WHENEV 


WHERE 


XCHNGE 


ZERO 










The monitor has 


the following SET commands* 






BLOCKS 


BREAK 


CDR 


CORMAX 


CORMIN 


CPU 


CTEST 


DATE 


DAYTIM 


DEFAUL 


DEFER 


DENSIT 


DSKFUL 


DSKPRI 


HOSTES 


HPQ 


MEMORY 


NODEFE 


NOMESS 


OPR 


PHYSIC 


RETRY 


SCHEDU 


SPOOL 


TIME 


TTY 


VIRTUA 


VMMAX 


WATCH 









The monitor has the following SET TTY commands t 

ALTMOD BLANKS COPY CRLF DEBREA ECHO ELEMEN 

FORM GAG HOLD IGNORE LC NO PAGE 

SLAVE SPEED TABS TAPE TIDY UC WIDTH 



FILL 
RTCOMP 



The monitor has the following SET WATCH commands? 

DAY MTA READS RUN VERSIO WAIT WRITES 
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♦ HELP DIRECT ^ 

Type out™ input? input)' ♦ ♦ ♦ 

/ACCESSJn «" access all listed files under n blocks lond 

/ALLOCATED :::: dive allocated lengths 

/AUTHOR "- output author of file 

/BEFORE* DATE* TIME ~- Just files created before this date-time 

/BLOCKS » siive lengths in blocks (default) 

/CHECKSUM ~ compute checksum of each file 

/DETAIL ~ everything? from extended LOOKUP 

/F " fast mode 

/FDTA ~ det DTA directors from core 

/H •- this text 

/L « out to LPT 

/N ~ normal mode 

/NOAUTHOR ™ don't output author (default) 

/NOCHECKSUM * omit checksums (default) 

/NODETAIL ™ don't use detail mode (default) 

/NOFDTA ■- don't sfet DTA directory from core (default) 

/NOPRDEVICE ■■■■- never print device 

/NOPRDIRECTORY : » never print directory 

/NOSQRT : - : omit sort options (default) 

/NOSUMMARY « don't use /SUMMARY mode (default) 

/NO TITLES « omit titles (default if TTYI) 

/NQUNITS * don't use /UNITS mode (default) 

/PRDEVICE ™ always print device 

/PRDIRECTORY : ~ always print directory 

/S ™ slow mode 

/SINCE* DATE* TIME ™ Just files created since this date-time 

/SORT « output in format amenable to sorting 

/SUMMARY : » Just print summary line 

/TITLES » include titles (default if not TTYI) 

/UNITS -give actual units for structures 

/W*n : ~ : try to fill paper width of n columns 

/WORDS ••- dive lengths in words 

/WRITTEN -~ dive lengths written (default) 

# is wild namei' etc* 

? is wild letter of name? etc* 
"out™" may be omitted 
default is TTYJ .DIR*DSK:*»*Cmw directory] 

on magnetic taper 

/DENSITY*. 200 or 556 or 800 - select the density 

/EOTS ~ stop at double file mark (DEFAULT) 

/FILES *n ™ stop after doing ri files (tape marks) 

/MARKS ~ note each end of file mark 

/N0E0TS ™ don't stop at double file mark 

/NOMARKS ™ don't annotate file marks (default) 

/NOREWINDS ~ don't rewind tape 

/PARITY* EVEN ~ read tape in even mode 

/PARITY* ODD ~ read tape in odd mode (default) 

/REWINDS =•••= rewind tape before and after (default) 
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♦ HELP INITIA L 

The INITIA command can be followed by one or more keywords* 



BATCH 

HELP 

KSYS 

NAME 

NORUN 

NOTICE 

SETTTY 

STRUCTURES 

TERMINET 

TEXT 

TTY 



indicate which r if any* batch system is running 

type this text 

indicate when time-sharing will cease 

(default) type system name 

suppress running any operator program 

type general operator notice 

(default unless logged in) setup terminal 

type any operator notes about mounted structures 

set tabs for a terminet -300 

TYPE QUICK OPERATOR NOTICE 

type tty mode settings for this terminal 



NO may preceed any of the above to override default settings 
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Function 

The INITIA command performs standard system initialization for 
the terminal issuing the command. This command is issued 
automatically at system startup and at the 400 series restart at 
certain designated terminals, you may reissue it at any time. 
This command is used to initiate specific system programs, such 
as the operator service program, OPSER, on a particular console. 

When INITIA runs, it finds the file with the name TTY.INI, which 
is an ASCII file created by you. TTY.INI contains 
installation-specified options indicating the characteristics of 
the terminal (s) to be initialized. If TTY.INI cannot be found, 
INITIA cannot initialize any devices and a start-up message is 
printed. 

Command Format 

INITIA or INITIA arg 

The command word INITIA can be followed by one or more 
keywords: 



BATCH 

HELP 

KSYS 
NAME 
NONAME 
NORUN 

NOTICE 
SET TTY 

STRUCTURES 

TERMINET 

TEXT 

TTY 



Types out the name of the batch that is 
running on the system (e.g., GALAXY). 

Types a list of available keywords and their 
meanings. 

Indicates when timesharing will cease. 

Types the system name (default) . 

Suppresses the typing of the system name. 

Suppresses the execution of any operator 
program. 

Types the general operator notice. 

Set up your terminal (default condition 
unless you have already logged in) . 



Types any operator notes 
structures. 



about 



mounted 



Sets tab spacing identical to a TERMINET-300 . 

Type quick operator notice. 

Types the TTY mode settings for this 
terminal. 



Characteristics 

The INITIA command: 



Leaves your terminal in monitor mode. 
Runs a specific system program. 
Does not require LOGIN. 
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Examples 

♦ INITIA L 

RK3A1A KL10 SYS#1026 14J52:34 TTY373 system 1026 
Connected to Node N0VA<3:L> Line # 41 
Job 35 User COSTLEYrB £.27*51101 
DSKB: Green DSKB 
DSKCt Green DSKC 
DSKN: System 1026 
YELBJ Yellow DSKB 
YELCJ Yellow DSKC 

. INITIA BATCH ^ 

RK3A1A KL10 SYS#1026 14:52:51 TTY373 system 1026 
Connected to Node NOVA (31) Line # 41 
Job 35 User COSTLEYyB C 27 » 5 11 03 

GALAXY SPOOLING AND BATCH SYSTEM 
DSKB J Green DSKB 
DSKC: Green DSKC 
DSKN: System 1026 
YELB: Yellow DSKB 
YELC: Yellow DSKC 

. INITIA STRUCTURES ^ 

RK3A1A KL10 SYS*1026 14:53:12 TTY373 system 1026 
Connected to Node N0VA(31) Line # 41 
Job 35 User COSTLEYYB C27»5110^ 
DSKB: Green DSKB 
DSKC: Green DSKC 
DSKN: System 1026 
YELBJ Yellow DSKB 
YELCJ Yellow DSKC 

♦ "C 
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Function 

The JCONTINUE command forces a continue of the specified job if 
the job was in a "C state because of a call to the device error 
message routine (HNGSTP) . 

Command Format 

JCONTINUE n 

n is the number of the job to be continued. This argument 
is required. 

Characteristics 

The JCONTINUE command: 

Places your terminal in monitor mode. 
Does not require LOGIN. 



Example 

,JCONT lA^J 
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Function 

The KJOB command: 

Stops all assigned I/O devices and returns them to the 

monitor pool. 

Returns all allocated core to the monitor pool. 

Returns the job number to the pool. 

Leaves the console in monitor mode. 

Command Formats 

KJOB/switch 

When you issue the KJOB command, the system checks to see if 
GALAXY is running. If it is not, refer to the second command 
format description below. If it is, the system runs the LOGOUT 
program, which accepts four switches. These switches are listed 
and described below. The switches are /FAST, /NOMESSAGE, /BATCH, 
and /HELP. 

FAST to log out immediately and save all files 
(including temporary files) as they are. This 
command is equal to an R LOGOUT command or a RUN 
monitor call to LOGOUT. Unpreserved temporary 
files (e.g., nnn???.TMP) are deleted where nnn is 
your job number and the files reside in your disk 
area. This is the default action of the KJOB 
command. 

BATCH to delete no files except when you are over the 
logged-out quota, then delete enough files to be 
below quota. The files are deleted in the 
following order: 1) unprotected files according 
to the category of the file; 2) spooled files not 
previously queued; and 3) protected files 
according to the category of the file. The 
categories of files are as follows: 1) temporary 
files, 2) relocatable files, 3) backup files, 4) 
save files, and 5) all other files. 

HELP to list the KJOB options and their meanings. 

NOMESSAGE this switch causes the same action as the /FAST 

switch, except that no output is printed at the 
terminal; i.e., all output is suppressed. This 

action is the default action for a detached job. 

The second format (described here) for the KJOB 
command is used when your system does not include 
GALAXY . 

The command responds with 

CONFIRM: 

you may type CTRL/C to abort the logout, or you 
may type one of the following letters (optionally 
followed by a space and a list of file structure 
names) : 
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to logout immediately and save all files (including 
temporary files) as they are. This command is equal to 
an R LOGOUT command or a RUN monitor call to LOGOUT. 

to delete all files on the specified file structures. 
It responds with DELETE ALL FILES? Type Y or D for 
YES, any other character for NO. 

to delete all unprotected files (i.e., files with Oxx 
protection codes) on the specified file structures. If 
project 1 or other jobs are logged in with the same 
project-programmer number, the K command responds with 
DELETE UNPROTECTED FILES? Type Y or K for YES, any 
other character for NO. 

to save and protect (i.e., assign a protection code of 
1 in the owner's field) all but temporary files (TMP, 
CRF, LST) on the specified file structures. If project 
1 or other jobs are logged in with the same 
project-programmer number, the P command responds with 
DELETE TEMPORARY FILES? Type Y or P for YES, any other 
character for NO. 

to save without protecting all but temporary files on 
the specified file structures. If project 1 or other 
jobs are logged in with the same project-programmer 
number, the S command responds with DELETE TEMPORARY 
FILES? Type Y or S for YES, any other character for 
NO. 

to list the directories of the specified file 
structures. 

to individually determine what to do with all files on 
the specified file structure. After each file name is 
listed type: 

to protect the file. 

S to save the file. 

K to delete the file. 

Q to learn if over logged-out quota on this 

structure. If not over quota, nothing is typed, 

and the same file name is repeated. 

E to skip to the next file structure and save this 

file if below logged-out quota for this file 

structure. If not below logged-out quota, the 

message ?file structure name LOGGED OUT QUOTA n 

EXCEEDED BY m BLOCKS is typed and the same file 

name is repeated. 

to list responses and meanings. 

to individually determine what to do with all but 
protected files. Protected files are always preserved. 
After each file name is listed, type one of the letters 
associated with the I command above. 

to delete no files except when user is over the logged 
out quota, then delete enough files to be below quota. 

to learn if over logged out quota on the specified file 
structure. 

to list the KJOB options and their meanings. 
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W to list the names of the files that are deleted. 

X to turn off the listing of names of the files that are 
deleted. Complement of W. 

If no file structure names are specified, the responses are for 
all file structure names in the job search list. If file 
structure names are specified, the responses apply to those file 
structures, and CONFIRM is retyped. The KJOB command ignoes all 
logical assignments. 

You have the option of going through the CONFIRM dialogue, even 
if other jobs are logged-in under the same project-programmer 
number or if you are logged in under project 1. (However, if 
sufficient responses are included on the KJOB command line or in 
a temporary file entered through an alternate entry point, 
CONFIRM is not typed). By responding to a CONFIRM message, you 
have an opportunity to organize this disk area by deleting or 
preserving specific files. 

The KJOB program calls the QUEUE program to perform the queueing 
of files which have been deferred to logout time. This includes 
all spooled output not previously queued. Queuing may be 
suppressed with the /Z response (see below) . 

KJOB 

CONFIRM: 

When the CONFIRM: response is typed, you may type any one 
of the above-described letters followed by a space, and an 
optional file structure name or a list of file structure 
names separated by commas. 

KJOB log file descriptor = /letter list 

the log file descriptor has the following format: 

dev: f ile.ext [pro j , prog] 

If the log file is not a disk or spooled device, TTY is 
used, and the message %LOG FILE DEVICE IS NOT DSK OR 
SPOOLED; WILL USE TTY is typed. 

letter is any letter from the above-described list. In 
addition, the following options are available to jobs using 
this command format: 

/Z:n specifies the degree of queueing desired: 

n = suppresses all normal queuing done at LOGOUT 

time. 

n = 1 queues only the log file. 

n = 2 queues the log file and spooled output. 

n = 3 queues the log file, spooled output, and *.LST. 

n = 4 queues the log file, spooled output, *.LST, and 

requests deferred to LOGOUT time (deferred requests are 

not yet implemented) . 

If Z is given without a value or if there are no spool 
bits set for this job, Z:0 is assumed. Otherwise, /Z : 2 
is assumed if /Z is not typed. 
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/VL:n specifies that the limit of pages for LPT files 
is to be n (decimal) . 

/VC:n specifies that the limit of cards for CDP files 
is to be n (decimal) . 

/VT:n specifies that the limit of feet of paper tape 
for PTP files is to be n (decimal). 

/VP:n specifies that the limit of minutes for PLT files 
is to be n (decimal) . 

/VR:n specifies that the priority of the queue request 
is to be n; n is from through 62 (decimal). /VR:10 
is the standard or default. 

VS:n specifies that the sequence number for the queue 
request is to be n (decimal). 

VD:n specifies that the file disposition of the log 
file is to be v. 

v = D deletes the log file after printing, 
v = P preserves the log file after printing, 
v = R renames the log file before printing to the 
queue area and deletes it after printing. 

The default is /VD:D. 

The letters must appear on the input side of the 
command string. If the log file is specified, all TTY 
output is appended to the log file. If no log file is 
specified or if the log file is not a disk or a spooled 
device, the default is TTY. In addition, if responses 
to CONFIRM are required and are not specified on the 
KJOB command line, these responses will then be read 
from TTY. Therefore, users should be careful when 
employing this command format. 

Any CONFIRM option that would ask fro re-confirmation 
(D always, and sometimes K, S, and P) must be repeated 
if it is on the KJOB command line) . 

The KJOB program may be entered at the CCL entry point 
through the RUN monitor call. When this is done, 
TMPCOR file KJO or disk file nnnKJO.TMP where nnn is 
your job number in decimal, is used instead of the TTY 
input. 
Characteristics 

The KJOB command: 

Deassigns your terminal. 

Stops all assigned I/O devices because it does not operate 

when a device is currently transmitting data. 

Runs the KJOB and LOGOUT programs. 



2-123 



KJOB Command (Cont.) 



Examples 

~c 



Jab 21 User COSTLEY»B C27»51103 

Loasled-off TTY41 at 16157100 on 29 -Jul -77 

Runtime? 0:00?04y KCS:<f>2» Connect time: 4t03t26 

D i sk Reads t 70 1 * W r i t es ? 29 » B 1 ocks saved : 25 

Job~34 User CUSTER *L. £27 r 4072! 
Loaaed-off TTY34 at 8 J 43 J 55 on 9-Aua~77 
Runtime: OtOOtOly KCS:i9» Connect timet 0: 13:39 
D i s k R e a d s 1 6 2 y W r i t e s 1 1 1 y B .1. o e k s s a v e d * 4 8 4 
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Function 

The LABEL command allows you to write an identifier onto a 
DECtape. This command is implemented for your convenience. The 
identifier is stored on the tape itself and is displayed when you 
list a directory of the tape with the DIRECT command. The PIP 
and FILEX programs can also read and write DECtape labels. As a 
user you should assign a unique label to each DECtape in order to 
avoid confusing one tape with another. 

Command Format 

LABEL dev: "name" 

dev: is a physical or logical name which represents a 
DECtape. 

is the delimiter of the DECtape identifier, which may be 
any non-alphanumeric character. 

name is a 1- to 6-character SIXBIT name to be used as the 
identifier. Any characters can be used except the 
delimiter . 

If the identifier consists entirely of alphanumeric 
characters, the delimiters can be omitted. 

The DECtape must be assigned to you before this command is 
executed. 

Characteristics 

The LABEL command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, thereby destroying your core image. 

Examples 

* I... A B E I... H T A 7 X C Q B (3 L X 1 ^J 

* I... A B E L D T A 3 : " P I P ♦ 3 3 n ^J 
. ASSIGN DTA002U..QGNAH ^y 

* LA BEL LOGNAM t "TAFID" ^ 



1 This command runs the COMPIL program, which interprets the command 
before running PIP. 
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Function 

The LIST command directs PIP to list the contents of named source 
file(s) on the line printer (LPT). The output goes either to LPT 
immediately or to the disk to be spooled to LPT if it is being 
spooled for this job. (Refer to the QUEUE and PRINT commands.) 
If the LPT is being spooled, the QUEUE program should be used 
instead of the LIST command since it saves time and disk 
accesses. 

Command Format 

LIST list 

list is a single file specification or a string of file 
specifications separated by commas. A file specification 
consists of a device name, a file name and extension, and a 
directory name. This argument is required. When a 
directory name precedes the file name, it becomes the 
default for all succeeding files. 

Switches can be passed to PIP by enclosing them in 
parentheses in the LIST command string. When COMPIL 
interprets the command string, it passes the switches on to 
PIP. 

Characteristics 

The LIST command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, thereby destroying your core image. 

Examples 

♦ LIST TEST** ^y 

♦ LIST Hc.MAC ^ 

♦ I... I ST DTA004 t AtBfC^J 



This command runs the COMPIL program, which interprets the command 
before running PIP. 
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Function 

The LOAD command translates the specified source files if 
necessary (function of COMPILE command), runs the linking loader, 
and loads the .REL files generated. The language translator used 
is determined by the source file extension or by switches in the 
command string. (Refer to the COMPILE command.) If a REL file 
already exists with a more recent date than that of the source 
file, compilation is not performed (unless requested via a 
switch) . 

This command generates a core image but does not begin execution. 
At this point, you can start your program or save the core image 
for future execution. 

Each time the COMPILE, LOAD, EXECUTE, or DEBUG command is 
executed, the command with its arguments is remembered in a 
temporary file on disk, or in core if the monitor has the TMPCOR 
feature. Therefore, issuing one of these commands without any 
arguments causes the arguments saved in the temporary file to be 
reused. (Refer to Section 1.5.) 

The LOAD command accepts several command constructions: the @ 
construction (indirect commands), the + construction, the = 
construction, and the < > construction. (Refer to Section 1.5 
for a complete description of each of these constructions.) 

Command Format 

LOAD list 

list is a single file specification or a string of file 
specifications separated by commas. A file specification 
consists of a device name, a file name with or without an 
extension, and a directory name. (Refer to Section 
1.4.2.4.) 

The following switches can be used to modify the command 
string. These switches can be temporary or permanent 
switches unless stated otherwise. (Refer to Section 1.5.5.) 

Switch Meaning 

/ALGOL Compile the file with ALGOL. Assumed for 
files with the extension of .ALG. 

/BIN Generate a binary file for each file 

compiled. The name for the binary file 

follows the standard conventions for 

determining the name of the output file. 

(Refer to Sections 1.5.2 and 1.5.3.) The 

extension is .REL. This is the default 
action. 



1 This command runs the COMPIL program, which interprets the command 
before running the appropriate language translator and linking loader. 
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Switch 
/BLISS 1 

/COBOL 
/COMPILE 



/CREF 



/FOROTS 

/FORSE 

/FORTRAN 



/FUDGE 



Meaning 

Compile the file with BLIS10. Assumed for 
files with the extension of .BIO and .BLI. 



Compile the file with COBOL. Assumed 
files with the extension of .CBL. 



for 



Force a compilation of this file even if a 
binary file exists with a newer date and time 
than the source file. This switch is used to 
obtain an extra compilation (e.g., in order 
to obtain a listing of the compilation) 
because, normally, compilation is not 
performed if the binary file is newer than 
the source file. 



Produce a cross-r 
disk for each 
processing by the 
name for the 
standard conventi 
of the output fil 
and 1.5.3.) The e 
can then be li 
However, with 
cross-referenced 
to the listing fi 
need be given to 



eference listing file on the 

file compiled for later 

CREF program. The file 

listing file follows the 

ons for determining the name 

e. (Refer to Sections 1.5.2 

xtension is .CRF. The files 

sted with the CREF command. 

COBOL files, the 

listing is always appended 

le. No additional command 

obtain the listing. 



Load the file with FOROTS 
object-time system) . 

Load the file with FORSE 
object-time system) . 

Compile the file with a 
Assumed for files with 
and .FOR and all files w 
translator extensions 
standard translator. Thi 
if the file has a nonrec 
extension and FORTRAN is 
translator or is not 
(e.g., LOAD/COBOL, TEXTl, 



(the new FORTRAN 



(the Old FORTRAN 



FORTRAN compiler, 
the extension of .F4 
ith nonrecognizable 
if FORTRAN is the 
s switch is needed 
ognizable translator 

not the standard 
the current default 
TEXT2, TEXT3/FOR) . 



Create a disk file containing the names of 
the .REL files produced by the command 
string. When the FUDGE command is given, PIP 
reads this file in order to generate a 
library REL file. (Refer to the MAKLIB 
Program description.) Arguments to the 
switch are: 

/FUDGE :dev: file. ext [proj,prog] 

dev: - the device on which to write the 
file. If the device is omitted, DSK: 
is assumed. 



BLIS10 will be recognized as a language translator only if the 



appropriate assembly switch 
setting is not supported. 



is set. However, this assembly switch 
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Switch 



Meaning 

file.ext - the name of the library file. 
The file name is required. If the 
extension is omitted, it is assumed to 
be .REL. 



/F10 



/F40 



/KA10 
/KI10 



/LIBRARY 



/LINK 



[proj,prog] - the directory in which to 
place the file. Your directory is 
assumed if none is given. 

This switch is permanent in the sense that it 
pertains to all REL files generated by the 
command string. 

Use the FORTRAN-10 compiler when compiling 
the associated FORTRAN file. This should be 
used as a permanent switch because it is not 
possible to load F40 and FORTRAN-10 binary 
files together. 

Use the F40 compiler when compiling the 
associated FORTRAN file. This is current 
default action. This should be used as a 
permanent switch because it is not possible 
to load F40 and FORTRAN-10 binary files 
together. 

Designate the machine on which the program 
will execute once it has been loaded. These 
switches are needed for FORTRAN-10 programs 
because the compiler generates different code 
for the KA10 and KI10 processors. The 
default is the processor on the computer 
executing the command. 

Load the files in library search mode. This 
mode causes a program file in a special 
library file to be loaded only if one or more 
of its declared entry symbols satisfies an 
undefined global request in the source file. 
The default libraries are always searched. 
(Refer to the LOADER and LINK-10 
documentation. ) 

Cause the file to be loaded by the LINK-10 
linking loader. If used, this switch should 
be placed before any file specifications 
because the COMPIL program may have to 
generate load-control switches. This is the 
current default action. 



/LIST 



Generate a disk listing file fo 
compiled. The file name for the 
follows the standard conve 
determining the name of the 
(Refer to Sections 1.5.2 and 
extension is .LST. These files 
later with the LST command, 
printer is being spooled for 
listing files are written on dev 
are automatically spooled at 
Unless this switch is specif 
files are not generated. 



r each 


file 


listing 


file 


ntions 


for 


output 


file. 


1.5.3.) 


The 


can be 1 


isted 


If the 


line 


this job 


, the 


ice LPT 


and 


LOGOUT 


time. 


ied, li 


sting 
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Switch 
/LMAP 

/LOADER 
/MACRO 

/MACY11 

/MANTIS 

/MAP 



/NEW 



/NOB IN 



/NOCOMPILE 



/NOLI ST 



Meaning 

Produce a loader map during the loading 
process (same action as /MAP) containing the 
local symbols. 

Cause the file to be loaded by the LOADER. 

Assumed for 



Assemble the file with MACRO, 
files with extension of .MAC. 



Assemble the file with MACYll. Assumed 
files with an extension of .Pll. 



for 



Compile the file with MANTIS. This 
affects F40 FORTRAN programs only. 



switch 



Produce a loader map during the loading 
process. When this switch is encountered, a 
loader map is requested from the loader. 
After the library search of the default 
libraries, the map is written in your disk 
area with either the file name specified by 
you (e.g., /MAP: file) or with the default 
file name MAP. MAP if loading is performed by 
LOADER or the file name nnnLNK.MAP if loading 
is performed by LINK-10. This switch is an 
exception to the permanent compile switch 
rule in that it causes only one map to be 
produced although it may appear as a 
permanent switch. 

Run the appropriate language translator from 
the experimental system library (device NEW:) 
area [1,5]. If the translator does not exist 
on device NEW: , try to obtain it from device 
SYS:. (Refer to the following NOTE.) 

Do not generate binary files. Unless this 
switch is given, binary files are generated. 
This switch, when combined with the /CREF or 
/LIST switch, is useful when compiling 
programs solely for the purpose of generating 
listings. 

Complement the /COMPILE switch by not forcing 
a compilation on a source file whose date is 
not as recent as the date on the binary file. 
Note that this switch is not the same as the 
/REL switch which turns off all compilation, 
even if the source file is newer than the REL 
file. /NOCOMPILE is the default action. 



Do not generate listing files, 
default action. 



This is the 
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Switch 
/NOMANTIS 

/NOSEARCH 



/OLD 



/REL 

/SEARCH 

/SELF 



/SNOBOL l 
/SYS 



Meaning 

Compile the file without the MANTIS debugging 
information. This switch affects F40 
programs only. 

Load all routines of the file whether the 
routines are referenced or not. Since this 
is the default action, this switch is used 
only to turn off libary search mode 
(/LIBRARY) . This is not equivalent to the /P 
LOADER switch because /P does not search any 
libraries where /NOSEARCH will scan the 
default libraries. 

Run the appropriate language translator from 
the system library of old programs (device 
OLD:) that resides on the disk area [1,3]. 
If the translator does not exist on device 
OLD:, try to obtain it from device SYS:. 
(Refer to the following NOTE, after /SYS.) 

Use the existing .REL files although a newer 
source file may be present. 

The action is identical to that of the 
/LIBRARY switch. 



Run the appropriate language 
device DSK: instead of f 
library (device SYS:). This 
for anyone who keeps a p 
translator in his own disk 
programmers occasionally ke 
versions of standard transl 
disk area in order to te 
(Refer to the following NOTE, 



translator from 
rom the system 
switch is useful 
rivate copy of a 
area. System 
ep experimental 
ators in their 
st new features, 
after /SYS.) 



Compile the file with SNOBOL. Assumed 
files with an extension of .SNO. 



for 



Run the appropriate language translator from 
the system library (device SYS:) area [1,4]. 
This is the default action. 



NOTE 

Once a language translator has been 
specified from a particular area (e.g., 
/SELF) , it cannot be called from a 
different area within the same command 
string. The following is illegal: 

. LOAD ITEM . CBL/SYS . ITEMO 2 . CBL/SELF 

However, the following is valid: 

.COMPIL ITEM. CBL/SYS 
.COMPIL ITEMO 2. CBL/SELF 
.LOAD /REL ITEM, ITEMO 2 



1 SNOBOL will be recognized as a language translator only if the 
appropriate switch is set. However, this assembly switch setting is 
not supported. 
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Characteristics 

The LOAD command: 



Leaves your terminal in monitor mode. 

Runs the appropriate language translator and linking loader, 

thereby destroying your original core image. 



Examples 



MAf 
I...0 



)AD TEST ^ 



:;ro t test 

A DING 



LOADER 2K CORE 
EXIT 
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Function 

The LOCATE command logically establishes your job at a specified 
network node. When your job is initiated, your logical station 
corresponds to your physical location. Therefore, this command 
is needed only if you wish to change your logical node/station. 
The main use of this command is to change the default device list 
of the job. For example, if you wish to have the devices at 
remote station CHRIS perform all I/O, you can issue the following 
command: 

.LOCATE CHRIS 

and the default I/O devices will be those on node CHRIS. 

Command Format 

LOCATE node-id 

node-id is the logical identifier of the node upon which you 
wish to be located. 

An argument of locates the job at the node where the job's 
command decoder is. A null argument implies the 
node/station of your terminal, i.e., his physical 
node/station. 

Characteristics 

The LOCATE command: 

Leaves your terminal in monitor mode. 

Is valid only in networks or in systems with a remote 

station. 

Restrictions 

The LOCATE command must specify a node/station that is currently 
in contact with the command decoder node/station. 



Examples 

. LOCATE 2 ^J 
♦ LOG ^J 
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Function 

The LOGIN command is used to gain access to the system. LOGIN 
loads a Monitor Support program that accepts your project and 
programmer numbers followed by your password. To LOGIN, type 
these numbers, then wait for the system to print PASSWORD:. Then 
type your password, which is not echoed. The numbers and 
password that you type must match those stored in the system 
accounting file (SYS:ACCT.SYS) . LOGIN waits two minutes for your 
response to PASSWORD: before printing an error message, killing 
your job, and asking you to start over. 

Command Format 

LOGIN "proj,prog" /switch or 

LOGIN [proj,prog] /switchl/switch2 ... 



The notation proj,prog stands for your proj 
numbers. These may be separated by eithe 
slash. If you use a slash, you do not recei 
message unless the date of the file 
(NOTICE.TXT) is later than the last date that 
If it is later, the system prints the daily 
first login only. If you use a comma, you 
message regardless of your last login time, 
[path spec] represents your default path for d 
you are logged in. If it is the same as 
numbers, you may omit it. One example of a 
[35, 3572, FOOBAR, STUFF] . You may type the proj 
on the same line as the LOGIN command; if, 
type a carriage return after LOGIN, you 
argument on the next line after the system pri 
sign (#) . 



ect-prog rammer 

r a comma or a 

ve the daily 

containing it 

you logged in. 

message on the 

receive the 

The notation 

isk I/O when 

your proj, prog 

path spec is 

,prog argument 

however, you 

may type the 

nts the number 



The following switches can be used to modify the command 
string. These switches may also be in SWITCH.INI. 

Most parameters set by these switches can be changed after 
login by the appropriate monitor commands. (See for example 
the SET commands and R SETSRC.) 



Switch 
/ALTMODE 



Meaning 

converts the ALTmode codes of 175 and 

176 (sent by some terminals to the 

system) to 033, the ASCII standard code 
for the ESCape character. (Normally, 

however, your terminal is initially set 
to send the 033 code.) 



/NOALTMODE 



restores the individual identity of 
codes 175 and 176. 



the 



/BLANK 



restores your terminal's characteristic 
(usually part of its initial setting) of 
printing carriage return/line feeds and 
form feeds at specified points in a 
program (before and after a DIR list, 
for example) . 
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Switch 
/NOBLANK 



/CORE : nP 
/CORE:nK 
/CRLF 

/NOCRLF 
/DEBREAK 

/NODEBREAK 
/DSKFUL: ERROR 



/DSKFUL: PAUSE 



Meaning 

suppresses blank lines (consecutive 
carriage return/line feeds after the 
first) and outputs form feeds and 
vertical tabs as two carriage 
return/line feeds. If your terminal is 
a video type, you can use this switch to 
increase the screen's capacity for 
output. 

tells the system that the job may use a 
maximum of n 512-word pages. 

tells the system that the job may use a 
maximum of n 1024-word blocks. 

restores the execution of a free 
carriage return/line feed at the 
terminal's right margin. Normally, the 
/CRLF condition is an initial setting. 

suppresses the execution of a carriage 
return/line feed at the terminal's right 
margin. 

tells the system that your terminal has 
a feature that allows the computer to 
lock the keyboard. (This feature exists 
only in Model 2741 terminals.) 

turns off the DEBREAK switch. 

causes a full disk to stop output and 
passes an error condition to the 
program. Most programs respond to this 
condition by issuing an error message 
and returning the job to monitor level 
without giving you a chance to continue. 
The default setting is ERROR unless 
specified as PAUSE. 

causes a full disk to stop output and 
suspends execution of the program. The 
system prints an error message on your 
terminal and returns control of the job 
to the monitor. To request assistance 
from the operator, you may issue the 
SEND command. To resume execution, 
however, you may issue a CONTINUE. The 
program will resume as long as you do 
not issue a command that destroys the 
interrupted program's core image. The 
program will be stopped again, however, 
if the problem of insufficient disk 
space, or of an exceeded quota, has not 
been corrected in the interim. The 
default setting is ERROR unless 
specified as PAUSE. 
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Switch 
/DSKPRI:n 



/ECHO 



/NOECHO 



/FILLrn 



Meaning 

allows a privileged user to set the 
priority for his job's disk operations 
(data transfers and head positionings) . 
Because the normal timesharing priority 
is 0, and permissible values range from 
3 to +3, the priority n can be higher or 
lower than standard. The specified 
priority applies to all disk I/O 
channels opened whose priority is not 
explicitly set with a DISK monitor call. 
(See DECsystem-10 Monitor Calls 
Manual.) The priority specified in 
DSKPRI remains in effect until 1) a SET 
DSKPRI command with a different priority 
is issued, 2) a KJOB command is issued, 
or 3) your program overrides the /DSKPRI 
switch by issuing a DISK monitor call 
with a different priority. Restrictions 
are as follows: the privileges required 
for using this switch are determined by 
bits 1 and 2 of the privilege word, 
.GTPRV; these two bits specify an octal 
number from 0-3; you are always allowed 
a priority. 

restores the normal echoing of each 
character typed in. Most terminals on 
the DECsystem-10 are used in full-duplex 
mode. In this mode, the monitor 
normally transmits to the terminal those 
characters that are to be printed; this 
process is called "echoing." If your 
terminal prints "C when you type it, but 
none of the other normally printing 
characters when you type them, you can 
use this switch to establish normal 
echoing. (The initial setting is 
determined by each installation when the 
monitor is built and its characteristics 
set. ) 



suppresses monitor ech 
characters. Local copy 
terminals that automatic 
character as you type it 
normal monitor echoing 
echoing would cause each 
to be printed twice, 
therefore, should be use 
printing of each charact 
local copy terminal, 
setting is determin 
installation when its mo 



oing of input 

terminals (i.e., 

ally print each 

) do not require 

, because the 

character typed 

This switch, 

d to stop double 

er typed on a 

(The initial 

ed by each 

nitor is built. ) 



tells the system that the filler class n 
is assigned to your terminal. Many 
different types of terminals are 
supported by the DECsystem-10 operating 
system. Some terminals require one or 
more filler characters to be sent 
following certain control characters 
such as LF (line feed) and HT 
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Switch 



/FORM 



/NOFORM 



/GAG 



/NOGAG 



Meaning 

(horizontal tab). The fi 
are CR (215 octal for e 
carriage return charact 
octal) and DEL (RUBOUT, 
all other characters. N 
supplied for image mode o 
number of fillers se 
character and filler clas 
table included in SET TTY 
FILL descriptions in thi 
initial setting is deter 
installation when its mon 



Her characters 
ven parity) for 
ers (CR, 215 
377 octal) for 
o fillers are 
utput. For the 
nt for each 
s, refer to the 
FILL and NO 
s manual. (The 
mined by each 
itor is built. ) 



tells the system that your terminal has 
hardware FORM (PAGE) and VT (vertical 
tab) characters, thereby allowing you to 
use them. (The initial setting is 
determined by each installation when its 
monitor is built.) 

tells the system that your terminal does 
not have hardware FORM and VT 
characters, thereby causing the monitor 
to simulate them by sending eight line 
feeds for a FORM and four for a VT. 
(The initial setting is determined by 
each installation when its monitor is 
built. ) 

allows your terminal to receive SEND 
messages, but only at monitor level. 
Normally, the /GAG condition is an 
initial setting. 

allows your terminal to receive SEND 
messages even when it is not at monitor 
level. 



/GUIDELINE 



/LC 



/NOLC 



specifies that the numeric value cited 
in the /PHYSICAL switch is a guideline. 
If not issued, /GUIDELINE is assumed; 
it is the default setting for /PHYSICAL. 

tells the system that your terminal has 
lowercase characters, and therefore 
prevents their translation to uppercase. 

causes the monitor to translate 
lowercase characters to uppercase as 
they are received. Some terminals have 
only uppercase characters, while others 
have both upperacase and lowercase. 
Frequently, it is convenient to have a 
terminal with both cases simulate the 
behavior of one with uppercase only. 
/NOLC causes this simulation. The 
monitor's echo always matches the case 
of the characters after translation. By 
looking at the printout, you can 
determine what translation the monitor 
has performed. Normally, the /NOLC 
condition is an initial setting. 
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Switch 
/LIB: [proj ,prog] 



/NOLIB 
/LIMIT 



/LOCATE : n 



/NAME : name o r 
/NAME: "name" 



/NEW 



/NONEW 



/NOTE:filespec, 



Meaning 

sets your job's library directory to the 
UFD [proj, prog] and adds it to your DSK 
specification. Consequently, a library 
area is set up to be searched. (See 
SETSRC, in this chapter.) 



removes the library directory 
from your DSK specification. 



(LIB:) 



specifies that the numeric value cited 
in the /PHYSICAL switch is a limit 
rather than a guideline. If /LIMIT is 
not issued, the system assumes that the 
numeric value given for the /PHYSICAL 
switch is a guideline. 

logically establishes your job at a 
specified station. When the job is 
initiated, your logical station 
corresponds to your physical station. 
You will need this switch, therefore, 
only in changing your logical station. 
When issuing the switch, type n to be 
the desired station number. 

associate the given name with your job. 
This name will appear on QUEUE'd output 
listings and on other information output 
by the system. The name should be 
enclosed in quotes if it contains 
punctuation characters. (This switch 
most commonly applies to BATCON version 
12 and SPRINT version 2.) 

tells the system to add the NEW 
directory to your SYS specification. As 
a result of this switch, the system, in 
conducting a search for any program or 
file, will first check the experimental 
directory [1,5]. The default setting is 
/NONEW. 

removes the [1,5] directory (NEW) from 
your SYS specification. It is the 
default setting for /NEW. 

prints the specified file, using the 
NOTICE.TXT logic. That is, it must be 
followed by the file name and extension. 
It is useful for printing a project 
notice that is being kept in a library 
area. For example, NOTE :*. TXT [33 ,437] 
will type all files with the extension 
.TXT. If the login project number is 
separated from the programmer number by 
a slash (/) instead of a comma (,), the 
files will be typed only if they were 
created after the last login. 
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Switch 
/PAGE 



Meaning 



/NOPAGE 



/PHYSICAL :nP 



/PHYSICAL :nK 



/QUOTA: str or 
/QUOTA: (strl, 



/RCVSPEED:n 
/RUN:filespec 

/SCAN 



enables you 
system typeo 
causes this 
features: 
suspends the 
CQ) , which 
neither echo 
This switch 
video termin 
of text bef 
Note that th 
of "S and 
(See /TAPE. ) 



to temporarily suspend 
ut without losing it. /PAGE 
condition by turning on two 
the XOFF key (~S) , which 

typeout, and the XON key 
restores it. These keys are 
ed nor sent to your program, 
is useful if you are using a 
al and wish to read a page 
ore it moves off the screen, 
is switch preempts the use 

"Q for reading paper tape. 



disables the typeout control functions 
of the XOFF and XON keys. The current 
interpretation of these keys depends on 
the last /TAPE issued. Normally, the 
/NOPAGE condition is an initial setting. 



specifies the maximum curren 
page limit (CPPL; see Chapt 
Monitor Commands Manual ) . 
stands for "pages," the 
represents the maximum number 
IP, therefore, would set a 1 
512-word page. This switch i 
on virtual memory systems, 
that it specifies will be 
PHYSICAL GUIDELINE or a PHYS 
depending on whether 
/PHYSICAL : nP/GUIDELINE 
/PHYSICAL :nP/LIMIT. If 
neither, /GUIDELINE is assume 



t physical 

er 1 of the 

Because P 

notation n 

of pages. 

imit of one 

s used only 

The value 

either a 

ICAL LIMIT, 

type 

or 

type 



you 



you 
d. 



specifies the number of blocks (K 
as the maximum current physic 
limit; IK would set a limit 
1024-word block. This switch 
only on virtual memory systems 
value that it specifies will be e 
PHYSICAL GUIDELINE or a PHYSICAL 
depending on whether you 
/PHYSICAL : nP/GUIDELINE 
/PHYSICAL :nP/LIMIT. If you 
neither, /GUIDELINE is assumed. 



) used 

al page 

of one 

is used 

The 

ither a 

LIMIT, 

type 

or 

type 



recomputes disk usage on all specified 
file structures. If none is specified, 
usage is recomputed on all file 
structures in your search list. 



sets to n baud the speed at 
system receives. 



which the 



will run the specified program unless 
another is designated by the system 
manager . 

sets the scan switch for the directory 
path. (See SETSRC, in this chapter.) 
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Switch 
/NOSCAN 

/SETTTY 



/NOSETTTY 



/SPEED :n 



/SPOOL :dev or 
/SPOOL: (devl, 

or 
/SPOOL: ALL 



/STR 



/NOSTR 
/SYS 



/NOSYS 



Meaning 

cancels the scan 
directory path. 



switch 



for 



the 



tells the system 
a SWITCH.INI fi 
followed by one o 
designate char 
terminal only (fo 
/NOBLANK /SETTTY 
therefore, causes 
file to supe 
counterparts. Th 
the default setti 



that your directory has 
le that contains LOGIN 
r more switches that 
acteristics of your 
r example: LOGIN /FORM 
WIDTH: 36). /SETTTY, 
the settings in this 
rsede their monitor 
e /SETTTY condition is 
ng. 



tells the system not to change any of 
your terminal's characteristics as 
designated in the monitor or in any SET 
TTY commands you have have issued before 
logging in. 

sets to n baud the speed at which the 
system sends and receives. (You can 
adjust your terminal's speed by setting 
its baud knob or button.) 



adds the speci 
current list of 
job. Spooling is 
I/O to or from 
simulated on d 
stored on disk 
output on the 
becomes availabl 
spooled: the 
card punch (CDP) 
the paper-tape 
plotter (PLT). 



fied device (s) to the 

those spooled for the 

the mechanism by which 

slow-speed devices is 

isk. Data temporarily 

can be automatically 

specified device when it 

e. These devices can be 

line printer (LPT), the 

, the card reader (CDR) , 

punch (PTP), and the 



causes all files in the standard system 
library [1,4] with name .STR. TXT to be 
typed on your terminal. Assume, for 
example, that there is a file on private 
structure "PR" called PRLSTR.TXT [1,4] 
which says: "PR: PAYROLL DEBUG PACK — 
NOT REAL DATA". Any user who logged in 
with /STR (or had /STR in his SWITCH.INI 
file) would have the warning message 
typed on his terminal. 

inhibits the printing of SYS:STR.TXT 

adds the SYS specification to your DSK 
specification. Consequently, if a file 
is not found in the directories on your 
search list or in your library directory 
(if /LIB [proj,prog] has been 
specified), the system directory [1,4] 
will then be searched for the file. 

removes the SYS specification from your 
DSK specification. 
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Switch 
/TABS 



/NOTABS 



/TAPE 



/NOTAPE 



/TIME:n 



/VIRTUAL :n 



/WATCH: (arg(l) , 
arg (2) , . . .arg (n) ) 



Meaning 

tells the system that your terminal has 
hardware TAB stops every eight columns, 
thereby allowing you to use this 
feature. (The initial setting is 
determined by each installation when its 
monitor is built.) 

tells the system that your terminal does 
not have hardware TAB stops, thereby 
causing the monitor to simulate them by 
sending the necessary amount of SPACE 
characters. 

allows your terminal to start and stop 
reading paper tape. /TAPE establishes 
this function by enabling the XON key 
("Q) to start the reading process, and 
the XOFF key ("S) to stop it. (See 
Chapter 5 of DECsystem-10 Monitor 
Calls . ) 

disables the special paper tape function 
of the XON and XOFF keys. These keys 
may have a PAGE function independent of 
/TAPE or /NOTAPE. Normally, the /NOTAPE 
condition is an initial setting. 

sets a central processor time limit of n 
seconds for a job. When the time limit 
is reached, the system stops the job and 
prints a message. A timesharing job may 
be continued by typing CONT, but unless 
the time is reset via the SET TIME 
command, no time limit will be in 
effect. A batch job cannot be 
continued. 

specifies the current virtual page 
limit, as represented by n. (For a 
description of CVPL, see Chapter 1 of 
the Monitor Commands 
/VIRTUAL :nK and :nP, K 
block, and P a page; 
words, and IP, 512 words, 
neither letter, K is assumed, 
specified within the range 1 



Manual. ) In 

represents a 

IK equals 1024 

If you type 

K may be 

to 512P. 



If /VIRTUAL :n is issued with a 
argument, the value of CVPL, as set by 
the system administrator, is used. 

sets the system to print the specified 
file incremental job statistics 
automatically. Thus, it provides you 
with a tool for measuring the 
performance of your programs. For 
example, you may type a line that reads 
/WATCH: READ or /WATCH : RUN or /WATCH: WAIT 
or /WATCH: DAY or /WATCH: VERSION or 
/WATCH: NONE or /WATCH :MTA or /WATCH 
followed by any combination of these 
arguments in parentheses and separated 
by commas. To include all these 
arguments, type /WATCH: ALL. 
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Switch 
/NOWATCH 

/WIDTH 



Meaning 

inhibits the printing of incremental job 
statistics. 

sets to n the carriage width (the point 
at which a free carriage return is 
inserted) . The range of n is 17 (two 
TAB stops) to 200 decimal. Normally/ n 
is initially set to 72. 



/XMTSPEED:n 



Characteristics 

The LOGIN command: 



sets to n baud the speed 
system sends. 



at which the 



Returns your terminal to monitor mode or starts a program 
running if specified in 

ACCT.SYS entry for proj,prog. 

Runs the LOGIN program. 

Example 

The following is the procedure used to gain access to the system. 



* LOGIN 
JOB 29 
#27*4662 



SCLIKA KL.10 SYS#1026 TTY250 



Password* 



1459 



17 -Aug- 7 7 



LOGIN types your assigned job number 
(job number 29), followed by monitor 
name, version number, and console line 
number. If you do not type your 
project-programmer number on the same 
line as the LOGIN command, LOGIN outputs 
a number sign indicating that you should 
type your project-programmer number. 

System requests you to type your 
password. You type password, followed 
by a carriage return (refer to Section 
1.4.2.1). To maintain password 
security, the monitor does not echo the 
password. On terminals with local-copy 
(refer to DECsystem-10 Monitor Calls ) , a 
mask is typed to make the password 
unreadable. 



Wed 



If your entries are correct, 

responds with time, date, 

week, the message of the day 

and a period, indicating readiness to 

accept another command. 



the system 
day of the 
(if any), 
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Function 

The MAKE command creates a new file on the disk with TECO (Text 
Editor and Corrector). If a file already exists with the same 
name, the system prints a warning message and supersedes the 
file, if you continue in TECO. If you type two CTRL/Cs to leave 
TECO, the system will not destroy the file. (Refer to the TECO 
manual in the DECsystem-10 Software Notebooks . ) 

Command Format 

MAKE dev: f ile.ext [project , programmer] 

dev: is the device or file structure name on which the 
system creates the file. If you omit it, the system assumes 
DSK. 

file.ext is any legal file name and file name extension. 
The file name is required; the file name extension is 
optional. 

[project , programmer ] is the directory area in which the 
system creates the file. If you omit the project-programmer 
number argument- the system assumes your default directory 
area (i.e., your project-programmer number). Note that the 
default directory may be an SFD or some other UFD. 

You can pass switches to TECO when you precede the switch 
with a slash in the MAKE command string. When COMPIL 
interprets the command string, it passes the switch to TECO. 

Characteristics 

The MAKE command: 

Places your terminal in user mode. 

Runs the TECO program, destroying your core image. 

Example 

♦MAKE TEST3.MIC 



1 This command runs the COMPIL program, which interprets the commands 
before running TECO. 

2-143 



MOUNT Command 



Function 

The MOUNT command allows you to request assignment of a device 
via the operator. This command is similar to the ASSIGN command, 
but, whereas the ASSIGN command operates without operator 
interaction, the MOUNT command requests operator interaction when 
necessary. For example, if a batch job requests a DECtape drive 
and all drives are in use, then the operator can free one for 
you, if you wish. With this command you can request devices from 
the restricted pool of devices, which you cannot do with the 
ASSIGN command. 

The MOUNT command gives the operator control over the assignment 
of devices on the system. When you request a device via this 
command, the operator has the option of selecting a specific unit 
(e.g., DTA5), or deferring your request, or canceling your 
request completely. For example, all units of this type are in 
use and the operator does not want to free one for you. The 
operator may also mount the medium for the requested unit if it 
is sufficiently identified (e.g., a deck of cards in the card 
reader or an identified DECtape on a specific drive). 

When you issue the MOUNT command to gain access to a file 
structure, you can specify a particular drive, and, if desired, 
place the file structure name at the end of your job's search 
list and wait for completion of operator action. Each file 
structure can have an administrative file, QUOTA. -SYS, which 
contains a list of quotas for all users allowed to access the 
structure. (Quotas for the structures in your default search 
list are contained in the file SYS:AUXACC.SYS. ) When the 
operator mounts a file structure, the system creates a UFD for 
you if you have an entry in the file structure's QUOTA. SYS or in 
SYS:AUXACC.SYS. 

The MOUNT command runs the UMOUNT program in your core area. 
UMOUNT scans the command string and completes as much of the 
command as possible without operator intervention. When operator 
intervention is required, UMOUNT queues a request to the OMOUNT 
program by writing a command file in the [3,3] disk area. OMOUNT 
examines these command files and interacts with the operator. 
When you delete the command file, the operator action has been 
completed. UMOUNT waits for this completion of operator action 
unless you have specified /NOWAIT or you type two CTRL/Cs. When 
you type two CTRL/Cs, you do not receive a message of 
confirmation, but you can later use the /CHECK switch to see if 
your request is still pending. (See the examples.) 

To insure validity of any tape error analysis, you should use 
MOUNT/DISMOUNT to acquire and release magtape units. This 
mechanism provides the basis for all media-related error 
reporting. 

Command Format 

MOUNT dev: logical-name/switches (drives) 

dev: is one of the following: 

1. A physical or generic device name (e.g., DTA3, CDRO, 
MTA) 
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2. A logical name you previously associated with a physical 
device by either a MOUNT or an ASSIGN command 

3. A file structure name (one that is already mounted or 
one whose name appears on STRLST.SYS) 

4. A spooled device name {e.g., LPT, PTP) , assuming these 
devices are spooled 

5. NUL:. This argument is required except when specifying 
one of the following switches: /CHECK, /HELP, or /WAIT. 
If you issue a MOUNT command for one drive (e.g., MTAl) 
and the operator selects another drive for you (e.g., 
MTA2) , then the system gives the logical name of MTAl to 
the physical drive (MTA2) so that batch control files 
that reference MTAl will work correctly. 

Logical-name is any SIXBIT name. The logical name may be a 
previously assigned name. If your request in which this 
name appeared has been processed, then MOUNT transfers the 
name from the previously assigned device to the device in 
this MOUNT command. If the previous request has not been 
processed at the time you specify the logical name again, 
then MOUNT creates a unique logical name of the form 
"Mnnnnn" instead of transferring the name from one physical 
device to another. It is recommended that you supply a 
logical name with any non-disk MOUNT request, because when 
you use generic device names, the logical name is the only 
way for you to know what physical device has been assigned 
by the operator. If you omit this field, UMOUNT either 
creates a unique logical name of the form "Mnnnnn" or it 
uses the physical device name. UMOUNT creates a unique 
logical name if you specify a generic device or if you 
specify a physical device that already has its name assigned 
as a physical or logical name by your job. UMOUNT uses the 
physical device name as a logical name in cases where you 
specify a specific device and the name is not already 
assigned as either a physical or logical name. 

You can use switches to further describe the device to be 
mounted or the requested action. These switches are 
optional unless otherwise indicated in the individual switch 
descriptions. The system processes the switches in the 
order you specify. Therefore, if there are any conflicting 
switches, the system uses the last one scanned in the 
command line. (An exception tot his is the use of the /WAIT 
and /NOWAIT switches within a single command string. If you 
specify both switches together, a fatal error results.) You 
may abbreviate the switch names to as few characters as are 
necessary to make the switch unique. 

/ACTIVE Mount the disk in your active search list. 
This means that the structure becomes part of 
generic DSK: and the system automatically 
searches it. (Refer to the SETSRC 
command.) /ACTIVE is the default condition. 

/PASSIVE Mount the disk in your passive search list. 
The disk is not considered part of generic 
DSK: and is not automatically searched; 
rather, it is merely available for use. 
(Refer to the SETSRC command.) 
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/CHECK 



Check and list your job's pending MOUNT 
requests. This switch is intended to be used 
by itself with the MOUNT command, and if a 
device specification or other switches appear 
in the command string with the /CHECK switch, 
the system ignores them. 



NOTE 

/C is a valid abbreviation of /CHECK. 
Therefore, if /CREATE is desired, you 
must type at least "/CR". 



/CREATE 



/NOCREATE 



/HELP 



/MULT I 
/PAUSE 

/REELID:name 



/RONLY 
/SHOVE 



Permit creation of files on this structure, 
default condition. Specification of this 
switch implies that /ACTIVE is in effect. 
(Refer to the SETSRC command.) 

Prohibit creation of files on this structure 
when DSK: is specified or implied. Files 
may be created on this structure if you 
explicitly use its name in the command line. 
Specification of this switch implies that 
/ACTIVE is in effect. (Refer to the SETSRC 
command. ) 

Type out a brief description of the MOUNT 
command. This switch is intended to be used 
by itself with the MOUNT command, and if a 
device specification or other switches appear 
in the command string with the /HELP switch, 
they are ignored. 

Allow multiple access, disk only, opposite of 
/SINGLE. /MULTI is the default condition. 

Notify you (to give you an opportunity to 
cancel the request) before queuing the mount 
request to the operator. 

A reel identification to be used when 
requesting a magnetic tape to be mounted. 
The argument, "name," is a 6-character ASCII 
string that is used to uniquely identify a 
reel of magnetic tape. This identification 
is included in any system-generated error or 
status reports about the drive while the reel 
is mounted. This switch is required when 
requesting magnetic tapes to be mounted. 

Read only, same as /WLOCK. 

Force the mount request to the operator even 
if SCHED 400 is set. 



/NOSHOVE 



/SINGLE 



Do not force the mount request to the 
operator even if SCHED 400 is set, default 
condition. 

Prohibit access to this structure by other 
users. You must be in the same project as 
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the owner of the pack to be allowed single 
access. File protection is enforced for you. 
This switch is applicable only to disk mount 
requests. 

/VIDrtext A visual identification describing the volume 
(DECtape, card deck, etc.) to be passed to 
the operator. This switch is required in 
MOUNT requests for DECtapes and for all 
input-only devices. 

The "text" can be up to 50 characters in 
length. For DECtapes, the text is the 
DECtape number, e.g., /VID:1326. If the tape 
is not numbered or if you do not wish to have 
the number checked, you must describe the 
tape by enclosing the "text" in single or 
double quotation marks. For example. 



MOUNT DTA.-/VID: "FRIDAY'S 
[13,2652]" 



FAILSAFE 



FOR 



For input-only devices, the text should be a 
description of the input. For example. 



MOUNT CDR:/VID: "PLEASE 
CARD-DECK: 'COBOL SOURCE'" 



LOAD 



THE 



BLUE 



Unquoted strings may contain only 
alphanumeric characters, periods, and 
hyphens. In quoted strings, the quotation 
marks are included in the 50 characters. 



/WAIT 



Wait before continuing with your job when 
operator intervention is required. When this 
switch is used in a command with a device 
specification and other switches, your job 
will wait for the request to be completed. 
When this switch is used alone (MOUNT/WAIT), 
your job will not continue until all of your 
pending requests have been processed. This 
format is useful only if a MOUNT dev:/NOWAIT 
was done previously or if you have typed two 
CTRL/Cs. In either case, the message 
"Waiting. . .Type 2 CTRL-Cs to Exit" is typed 
on your terminal. /WAIT is the default 
condition. 



NOTE 
/W is a valid abbreviation of /WAIT. 



/NOWAIT 



Do not wait if the operator intervention is 
needed to process your pending requests. 
This switch is particularly advantageous when 
running batch jobs. In timesharing jobs the 
use of the /NOWAIT switch merely saves you 
from typing two CTRL/Cs (~C"C). 



/WENABL 



Permit writing for your job. 
default condition for disk. 



This is the 
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/WLOCK 



/WRITE: NO 



Prohibit writing for your job. Your job may 
not write on this device or file structure 
and the monitor will not update BAT blocks or 
the access date. If you specify /SINGLE , 
the operator may set hardware write-lock to 
ensure that nothing is written. In addition, 
the write-status of all tapes is verified so 
you must specify the correct setting. 
Hardware write-status is not checked for disk 
and a [1,2] job may write on a disk mounted 
with /WLOCK, so care should be taken if you 
are [1,2] and do not wish to write on the 
disk. /WLOCK is the default for magnetic 
tape and DECtape. 

Same as /WLOCK. Permit writing. This is the 
default condition for disks. 



/WRITE: YES Same as /WENABL. Prohibit writing, 
the default condition for tapes. 



This is 



(drives) are the physical drives on which the units are to 
be mounted. A drive argument may be used only when mounting 
file structures. The drives must be in the logical unit 
order within the file structure. Drive names are separated 
by commas. Leading and embedded drives that are not 
specified must be represented by null names (,,DPS3). 
Unspecified trailing drives may be omitted. Drive names are 
as follows: 

Blank, null - unspecified, UMOUNT finds one of proper type. 

Two letters - controller class (e.g., DP). 

Three letters - specific controller (e.g., DPA) . UMOUNT 
finds drive on that controller. 

Three letters and one or two digits - specific drive (e.g., 
DPAO, DPA1). 

By specifying a drive list, you may only suggest that the 
packs be mounted on specific drive, s or controllers. If you 
do not specify a drive, the system finds an available drive 
of the proper type. if you specify a drive incorrectly for 
the named structure, or the drive is unavailable, you are 
informed and the requests are then queued. 



Characteristics 

The MOUNT command: 



Places your terminal in user mode. 

Runs the UMOUNT program, destroying your core image. 



Examples 



. M U NT M T A F A I L S A / R E E I... I D i 4 5 6 / V I D i " I H U R S DAY" S l : " A I L S A T A I" 1 E F R 1.1 S K A y / 

REQUEST QUEUED 

W A 1 T I NO,.* 2 "■ C ' S T E X I T 



2-141 



MOUNT Command (Cont.) 

This MOUNT command requests that the operator mount the magnetic 
tape identified as "Thursday's FAILSA for DSKA." This 
identification is accomplished either by a label affixed to the 
reel or canister or by an understanding between the operator and 
the requesting user. The /REELID switch specifies that the tape 
is to be identified as reel number 456 in all error reports. In 
order to associate the error reports with the reel on which the 
errors occurred, it is recommended that a label bearing the reel 
identification be attached to the tape reel. This command also 
specifies that the logical name FAILSA is to be associated with 
the physical drive on which the reel is mounted. 

« M U N T M T A 1 / R E E I... I D H. 2 3 / V I D " P A Y R Q I... I... M A S T EL' R " *J 
REQUEST QUEUED 
WAITING, ♦ *2 "CS TO EXIT 
MTA MOUNTED r MTB.1.0I USED 



♦ SYS TAT ^7 






24 .1. 0*4072 


TTY11 


SYS TAT 


* MEANS EXECUTE 


ONLY 




BUSY DEVICES? 






DEM ICE JOB 


WHY 


LOGICAL 


MTB10.1. 24 


AS 


MTA 1 Oil. 



1.2+ SPY RN 23 



This MOUNT command asks the operator to mount a magnetic tape 
with a REELID of 123 and the external label "PAYROLL MASTER" on 
MTAl. The operator was unable to use MTA1 so he selected MTB1 
instead. However, OMOUNT assigned the logical name MTAl to the 
physical device MTBl. This feature is especially useful in batch 
control files and allows you to continue to refer to the tape as 
MTAl. 

♦ M U N T B L K C / N W A I T *J 
REQUEST QUEUED TO MOUNT UNITS 

This MOUNT command asks the operator to mount the file structure 
BLKC:. You want to return to monitor command level after the 
request is queued, without waiting for the operator to service 
the request. 

. MOUNT DTA/UID?:l.234 ^y 

REQUEST QUEUED 

WAITING . ♦ .2 T'S TO EXIT 

"C 

Then you ask the operator to mount the DECtape labeled both 
magnetically and externally, 1234. You did not specify /NOWAIT 
so you received the "Waiting... 2 "Cs to Exit" message. However, 
you decided not to wait and returned to monitor command level by 
typing two CTRL/Cs. 

♦ M U N T D T A / V I D : 5 6 7 S ^J 
REQUEST QUEUED 
WAITING* ♦ *2 "C'S TO EXIT 
DTA MOUNTED)- DTAIOI USED< 
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Next, you request that the operator mount the DECtape labeled 
5678. This time, you wait until the DECtape is mounted before 
continuing with your job. You are notified that the DECtape is 
mounted on DTA1. 

* MOUNT/CHECK *J 

1* M JOB 5 TTY10J5 .1.0 t 4072 1 MOUNT DTA M44321 /VM.234 /WL /AFTER M.4 ■■■■MAR 

-75 t 17 120 

1 COMMAND IN QUEUE 

The response from the MOUNT/CHECK command indicates which of your 
requests have not been processed. Because BLKC is not listed in 
the queue, that request has been serviced. You can type 
"RESOURCES" to see if the operator mounted the file structure. 
The mount request for DECtape 1234 is still pending. /AFTER 
indicates that the operator has deferred servicing this request 
until 17:20 on 14-Mar-77. The last line indicates that the total 
number of MOUNT requests pending for all users is one. 

. MOUNT/WAIT ^ 

WAITING. ♦ ,2 T'S TO EXIT 

You now decided to wait until all your pending requests have been 
processed. The line "Waiting. .. 2 ~Cs to Exit" indicates that 
UMOUNT is waiting. 

. MOUNT/CHECK ^ 

NONE PENDING FOR YOUR JOB 

:l. COMMAND IN QUEUE 

* 

Finally, you verified that all your requests have been processed. 
Note that some other user has issued a MOUNT command since you 
last issued the MOUNT/CHECK. 
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Function 

The MTCOPY program copies entrie contents of one magnetic tape to 
another magnetic tape, or copies selected files from one magnetic 
tape to another magnetic tape. 

Command F or mat 

R MTCOPY 

*output MTA:/output switches = input MTA:/input switches 

The file switches are: 

/2 200 bits/inch 

/5 556 bits/inch 

/8 800 bits/inch 

/A:n Advance n files before operation 

/B:n Backspace n files before operation 

/E Even parity 

/I Industry-compatible mode 

/R Rewind before and after operation (default) 

/U Unload after operation 

The general switches are: 

/C:n Copy n files (input only) 

/C Copy to double EOF 

/G Proceed on errors 

/H Help 

/N Suppress automatic rewinds 

/V:n Verify n files 

/V Verify to double EOF 

Neither /C nor /V defaults to /C/V. A count on either /C or /V 
applies to both. 

The system preserves density across commands until you specify 
that the tape is to be unloaded or rewound. /A, /B, and /N 
suppress automatic /R. /R without /A or /B restores automatic 
rewinds. Devices need not be reset for new commands. 

Spaces and tabs are ignored. Comments are preceded by a 
semicolon; switches may be included in parentheses. 

Characteristics 

The R MTCOPY command: 

Places your terminal in user mode. 

Runs the MTCOPY program, destroying your core image. 

Examples 

♦ R MTCOPY ^ Run MTCOPY. 

* MTA 1 1 C/V/2«MTA2 : <J Copy and verfiy a 200 bits/inch magtape 

from MTA1: to MTA2 : . 

* MTA2?/A?2/Ct3/VS3~ Copy and verify files 3 to 5 from MTA2 : 
«MTA3? ^y to file 4 on MTA3 : . 

» MTAOtAM«riTAQ: ^ Position MTA0 : to the beginning of the 

fourth file. 
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Function 

The NODE command has four distinct functions, determined by the 
number of arguments given in the command string. 

Number of 

Arguments Function 

Type out the node-id and related information for 
each known node in the network. 

1 Type out the node information of the specified node. 

2 Assign the designated I/O device on the specified 
node. The logical device name is the same as the 
physical device name. 

3 Assign the designated I/O device on the specified 
node. The logical device name is the one given in 
the command string. 

Command Format 

NODE node-id physical-device-name logical-device-name 

node-id is the node identifier of the node on which the device is 
to be assigned. 

physical-device-name is any physical device name followed by a 1- 
to 3-digit number representing a unit number. If you omit n, the 
monitor attempts to assign any device of the designated type or 
any file structure name. 

logical-device-name is a logical name of up to six characters you 
assign. This argument is optional and if omitted, the logical 
name will be the same as the physical name. Except for disk 
devices, you can assign only one logical name to a physical 
device. Subsequent NODE commands to all devices, except disk 
devices, replace the old logical name with the new one. You can 
disassociate all logical names from all devices by issuing the 
DEASSIGN command. 

Characteristics 

The NODE command: 

Leaves your terminal in monitor mode. 

Restrictions 

You must use a space, tab, or underscore to separate the node-id 
and the physical device name. You must use a space or a tab to 
separate the physical and logical device names. 

Examples 

♦ NQDE ^ 

NODE KL 1026 (26) SCLIZA KL10 SYS* 1026 07-24-77 

MCRC13 CDRC13 LPT C 33 PTRC13 PTPC1.1 MTAC93 DTAC83 TSKC163 
NODE CTCI-I22<22> DN82 VI 1(24) 07-JUN-77 

TTYC333 CDRCU LPTC13 
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Function 

The NSAVE command writes out a core image of your core area on 

the specified device. (Note that files on DECtape cannot be 
NSAVED.) If the file to be saved is in .EXE format, only one file 

will be written instead of the standard high and low files. When 

the program is subsequently loaded by a GET, R, or RUN command, 
it will be nonsharable. 

Command Format 

NSAVE dev: file . extension [proj, prog] core 

Arguments and defaults are the same as in the OSAVE command. 

Characteristics 

The NSAVE command: 

Leaves your terminal in monitor mode. 

Requires core. 

Does not operate when a device is currently transmitting 

data. 

Examples 



<■ NSAVE TEST ^y 
TEST SAVED 



2-153 



NSSAVE Command 



Function 

The NSSAVE command writes out a core image of your core area on 
the specified device. (Note that files on DECtape cannot be 
NSSAVEd.) If the core image to be saved is in the new .EXE 
format, only one file will be written instead of the standard 
high and low files. When the program is subsequently loaded by a 
GET, R, or RUN command, it will be sharable. 

Command Format 

NSSAVE dev: file. extension [pro j , prog] core 

Arguments and defaults are the same as in the OSAVE command. 

Characteristics 

The NSSAVE command: 

Leaves your terminal in monitor mode. 

Requires core. 

Does not operate when a device is currently transmitting 

data. 



Example 



» NSSAME TEST ^ 
TEST SAVED 
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Function 

The OPSER program facilitates multiple job control from a single 
terminal by allowing you to run up to 14 jobs, called subjobs, 
from your terminal. The OPSER program acts as the supervisor of 
the various subjobs by allowing monitor level or user level 
commands to be passed to all of the subjobs or to selected 
subjobs. Output from the various subjobs may be retrieved by 
OPSER. 



The subjobs of OPSER run on pseudo-TTYs 
Monitor Calls ) and all initializatio 
performed by OPSER. You need only to pr 
either an OPSER-provided subjob number 
System programs, as well as programs you 
dedicated terminal can be run as subj 
jobs on pseudo-TTYs, OPSER is able to 
between you and the running jobs. In 
the various subjobs is concentrated on o 
many, as was the case when each p 
terminal. 



(refer to DECsystem-10 

ns of the pseudo-TTYs are 

ovide the subjob name and 

or a user assigned name. 

write that require a 
obs of OPSER. By running 

maintain an I/O link 
addition, the output from 
ne terminal instead of 
rogram required its own 



The OPSER program is primarily intended for use by the system 
operator in controlling the separate components of the 
multiprogram batch facility. However, all users can employ this 
program for their own purposes. (Refer to the OPSER 
specification in the DECsystem-10 Software Notebooks and Appendix 
A of the Operator's Guide for information on OPSER.) 



Command Format 

R OPSER 



OPSER signifies its readiness to process commands by typing 
an asterisk if no subjobs are in use or subjobs are in a 
wait state for an operator action. OPSER responds with an 
exclamation point when a subjob is running. Commands may be 
entered whenever OPSER is operating. Each command is 
preceded by a colon and must be typed to sufficient length 
to make it unique. 

OPSER Commands 



Command 
:AUTO/hh:mm 



Meaning 

Process the specified file as an 
automatic startup file. The execution 
of the file is terminated by an 
end-of-file or by the operator typing on 
the console. This is the normal way 
that the standard subjobs are started by 
the operator. The time argument is 
optional: when it is given, the AUTO 
file is run at the specified time. 
Comments can be included in an AUTO file 
by preceding the comments with a 
semicolon. For example, 



:SLOGIN 

: LOGIN A NEW SUBJOB 
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Command 
:AUTO/ >hhmm 

:AUTO/ >hhmm 

: CLOSE 

: CONTINUE 

: CURRENT 



: DAYTIME 
:DEFINE xxx=n 

: DEVICE nam log:n 



: ERROR n,m,p 



:EXIT 



.•FREE 
:HELP 

:JCONT n 
:KILL n,m,p 



Meaning 

Process the AUTO file at the next 
occurrence of hhmm. 

Don't process the AUTO file if time is 
past hhmm. 

Close the disk log file without opening 
a new one. 

Continue processing the AUTO file after 
it has been interrupted by a Control-C. 
This allows the operator to gain control 
of a subjob during auto file processing. 

Type name, if defined; otherwise, type 
the number of the current subjob (the 
last one typed into) . Output from 
another subjob does not affect current 
subjob. 

Obtain the current date and time. 

Associate the symbol xxx as the mnemonic 
for subjob number n. The symbol B is 
reserved for the subjob running BATCON. 

Assign the device with the physical name 
,nam, and logical name, log, to subjob 
n. The logical name is optional, but 
you must type a null field if the name 
is omitted, e.g., :DEVICE CDR::3. The 
command re-ENTER will abort the request. 

Report only error messages (that is, 
ignore nonerror messages from subjob n) . 
Message reporting is resumed with the 
: REVIVE command. 

Exit to the monitor if no subjobs are in 
use; otherwise, give a list of those 
that are running. This should be used 
instead of "C, because EXIT does not 
return your job to the monitor mode if 
there are any active subjobs. (See 
also: MONITOR.) 

Type the first free subjob number. 

Type a text which briefly explains the 
commands. 

Continue the specified stopped job. 

Kill the specified subjobs. This is 
identical to :KJOB. 
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Command 
:KJOB n,m,p 

:KSYS hhmm 
:LOGIN proj,prog 

: MONITOR 
:MSGLVL 
:MSGLVL 1 
:QUEUE <line> 

: RESOURCES 

: RESTRICT dev: 
: REVIVE n 

:SCHED 



:SEND line 
:SET a 



Meaning 

Kill the specified subjobs, saving all 
files. 

Operator-privileged command. 1 

Login a new subjob. If no 

project-programmer number is typed, 

assume OPSER's project-programmer 
number. 

Exit to the monitor, even if subjobs are 
running. (See also :EXIT.) 

Cause the response to the :WHAT command 
to include the JOBSTS bits. 

Cause the response to :WHAT command to 
eliminate the JOBSTS bits (default). 

Initiate the first free subjob and send 
the typed-in line to the system queue 
manager. 

Type the list of the available system 
resources. 

Operator-privileged command. 1 

Resume normal echoing of output from 
subjob n (i.e., clear effects of 
: SILENCE, :TSILENCE, and : ERROR for 
subjob n) . 

Type out the schedule bits as set by the 
operator. Bits are: 

Regular timesharing 

1 No further LOGINs except from CTY. 

2 No further LOGINs from remote 
terminals, and no answering of data 
sets 

4 Batch jobs only 
100 Device MOUNTs can be done without 

operator intervention 
200 Unspooling allowed 
400 No operator coverage 

Simulate the SEND monitor command. 

Simulate a SET monitor command. Valid 
SET monitor commands are SET CORMAX, SET 
CORMIN, SET DATE, SET DAYTIME, SET OPR 
TTY, SET SCHED, and SET TTY. 



See Appendix A of the Operator's Guide, 
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Command 
:SET BATMAX n 
:SET BATMIN n 
:SET LOGMAX n 
:SET RUN 
:SILENCE n 
:SLOGIN pro j, prog 

-.STOP n 

: SYSTAT xx 
:TIME 

:TLOG file spec 



iTSILENCE n 

iTTYTST 

:UNRESTRICT dev: 
:WHAT n,m,p 



: WHERE devn: 



Meaning 

Operator-privileged command. 1 

Operator-privileged command. 1 

Operator-privileged command. 

Operator-privileged command. 

Suppress all output from subjob n. 

LOGIN one subjob but suppress its 
response. If proj,prog is omitted, 
OPSER uses its own. 

Put the specified subjob in monitor 
mode. This is equivalent to inputting 
two CTRL/Cs in interactive mode. 

Run SYSTAT with optional argument xx 
over the first free subjob. 

Type out the total running time since 
the last :TIME command, followed by the 
integrated product of running time and 
core size. 

Create a disk log file with the 
specified name. If the file already 
exists, a message is typed to determine 
whether the existing file should be 
superseded. If not, the file is 
appended to the existing one. Default 
for filespec is 0PSER.LOG. 

Suppress all output from subjob n (same 
as the : SILENCE command) but place 
entries into the log file. 

Test this terminal by typing all the 
ASCII characters between octal 40 and 
174, inclusive. 

Operator-privileged command. 1 

Type the status of the specified subjobs 
on the terminal. The status includes a 
SYSTAT with the time, the time of the 
last input and the last output, a linear 
listing of the JOBSTS bits depending 
upon the value of :MSGLVL and the time 
of the next timed AUTO file. 

Type out the station number of the 
device's physical location. 



See Appendix A of the Operator's Guide, 
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When a subjob number or name is required in a command string, the 
subjob can be specified in one of four ways. It can be omitted, in 
which case the last subjob typed into is used; the mnemonic ALL can 
be used, in which case all active subjobs are implied; decimal number 
can be used, from zero to the limit OPSER is generated for; or a 
mnemonic previously assigned to the subjob with the :DEFINE command 
can be used. 



Examples 

♦ R OP SER *J 

♦ LQGI N^ 

! 16:09M6<0) 

JOB 13 



SCLIZA KL10 SYS#1026 TTY434 



?OPRJRO Job<s) running on 

?OPRJRO Type "J KILL ALL" to kill the sub Jobs 

* skill ALL ^y 
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Function 

The OSAVE command writes out a core image of your core area on 
the specified device. It saves any user program (two-segment 
sharable, one-segment nonsharable, or two-segment nonsharable) as 
one or two files. Later, when the program is loaded by a GET, R, 
or RUN command, it will be nonsharable. If DDT was loaded with 
the program, the entire core area is written; if not, the area 
starting from zero up through break (as specified by .BSA, left 
half) is written. The save command stores JOBVER in .RBVER when 
saving .LOW and .SAV files; and it stores JOBHVR in .RBVER when 
saving .HGH and .SHR files. (Refer to the DECsystem-10 Monitor 
Calls for a description of the job data area locations referenced 
by this command.) 

You should use the OSAVE command instead of the OSSAVE command 
when debugging a two-segment program. 

On magnetic tape, if the low or high segment is missing, a null 
record is output before the EOF for the missing segment so that 
two EOFs cannot occur consecutively. Therefore, a saved null 
segment does not appear as a logical EOT (TWO EOFs in a row) . 
When loading, the high segment is always referred to because the 
low segment file may not exist; the opposite holds for the other 
.SAV file format. 

When running under a virtual memory system, DAEMON will be called 
on an OSAVE command if any pages are paged out or your job has a 
non-contiguous core image. 

Command Format 

OSAVE dev: file. ext [proj , prog] core 

dev is the device on which the core image file is to be 
written. The default device name is DSK:. In nondisk 
monitors, the default is the generic name that matches the 
system device. The colon following the device name is 
required if a device is specified. 

file. ext is the name to be assigned to the core image file. 
The default file name is your job's current name as set by 
your last R, RUN GET, OSAVE, or OSSAVE command; the last 
command that ran a program (e.g., DIRECT); or the last 
SETNAM monitor call. 

ext applies to the file name used for the low segment not 
within the high segment. 

[proj, prog] is the location on the disk area where the core 
image file is to be written. 

core is the amount of core in which the program is to be 
run. This value is stored in JOBDAT as the job's core area. 
(.JBCOR) and is used by subsequent RUN and GET commands. 
This argument is optional. 

You can specify core arguments in units of 1024 words or 512 
words (a page) by following the number with K or P 
respectively. For example, 2P represents 2 pages or 1024 
words. If you do not specify K or P, K (1024 words) is 
assumed. 
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Note that on KAlO-based systems (DECsystem-1040 , 1050, 
1055), the minimum unit of allocation is 1024 words. 
Therefore, all arguments are rounded to the nearest multiple 
of 1024 words (e.g., 3P is treated as 2K on a KAlO-based 
system) . 

If core is omitted, only the number of blocks required by 
the core image area (as explained in the RUN command 
description) is assumed. 



Characteristics 

The OSAVE command: 



Excimple 



Leaves your terminal in monitor mode. 

Requires core. 

Will not operate while a device transmits data. 

1. If a two-segment core image is being saved, the high 
segment is saved with the file ext. .HGH, and overwrites 
any previous file similarly named. 

2. If TEST.SHR exists when the OSAVE TEST is given, then 
TEST.SHR is deleted. 



* OSAVE TEST ^y 
TEST SAVED 
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Function 

The OSSAVE command is the same as the OSAVE command except that 
the high segment, if present, will be sharable when it is loaded 
with the GET command. To indicate this sharability, the high 
segment is written with extension .SHR instead of .HGH. A 
subsequent GET will cause the high segment to be sharable. 
Because an error message is not given if the program does not 
have a high segment, you can use this command to save system 
programs without having to know which are sharable. 

On magnetic tape, if the low or high segment is missing, a null 
record is output before the EOF for the missing segment so that 
two EOFs cannot occur consecutively. Therefore, a saved null 
segment does not appear as a logical EOT (TWO EOFs in a row) . 

You should use the OSAVE command instead of the OSSAVE command 
when debugging the program. This is because a GET command after 
an OSAVE command does not reinitialize the original high segment 
from the file after you modify it with the D command or the DDT 
program. 

When running under a virtual memory system, DAEMON will be called 
on an OSSAVE command if pages are paged out or the core image is 
non-contiguous. 

Command Format 

OSSAVE dev: file. ext [proj , prog] core 

Arguments and defaults are the same as in the OSAVE command. 

Characteristics 

The OSSAVE command: 

Leaves your terminal in monitor mode. 

Requires core. 

Will not operate while a device transmits data. 



Example 



♦ os save test ^ 

TEST SAVED 
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Function 

The PJOB command causes the monitor to respond with the following 
information: 

1. Your job number 

2. Your user name 

3. Your project-programmer number 

4. Your terminal number 

This command is in the KAFULL, KIFULL and KLFULL monitors, under 
the feature test switch FTPJOB. 

Command Format 
PJOB 

Characteristics 

The PJOB command: 

Leaves your terminal in monitor mode. 

Example 

♦ PJOB 

JOB 49 USER CUSTER , I... , L27 ? 40721 TTY240 
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Function 

The PLEASE command allows you non-conflicting two-way 
communication with the designated station operator. 

Command Format 

PLEASE dev:prog! text 

dev is any terminal not assigned to a job (i.e., is not a 
job's controlling terminal) with which you wish to 
communicate, including: 

1. TTYn: directs the text to a specific terminal unit. 
The default is TTYO. 

2. OPRnn: directs the text to the operator's terminal at 
node nn. 

3. (null argument) directs the text to TTYO at the central 
node. 

prog! is the name of the system program to be run 
automatically when the message is completed. This argument 
may appear before or after the device argument and must be 
concluded with an exclamation point. If PLEASE is entered 
at the CCL entry point, it reads file nnnPLS.TMP. This file 
is sent to the designated device. After the operator 
terminates the request, the specified program will be run at 
its CCL point. Neither the dev: nor prog! argument can be 
used from a batch control file. 

text is your message. The argument is required. Characters 
are not transmitted until the RETURN, vertical tab, or form 
feed is depressed, at which point the entire line is 
transmitted. 

When you depress the RETURN, vertical tab, or form feed key, 
a message informing the operator of the caller's node 
number, project-programmer number (or user name if monitor 
job tables are available) , and text message is printed on 
dev:. In addition, PLEASE prints time information involved 
in the transmission. An ESCAPE on CTRL/C on either your 
terminal or dev: causes communication to terminate and your 
TTY to be left in monitor mode. Note that when the line 
terminates with an ESCAPE, the line is typed but the 
operator response is not waited for. Messages may be typed 
in both directions without retyping the command. 

Characteristics 

The PLEASE command: 

Places your terminal in user mode until you type an ESCAPE. 
Runs a system program except when used with batch. 

Restrictions 

For batch users, the PLEASE command is trapped by the Batch 
Controller and only PLEASE text is allowed. It can be used to 
request operator action while in the batch mode. The line of 
text can only be one line and may or may not be terminated with 
an ESCAPE. 
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Example 



* PLEASE TELL ME WHEN DTA013 WILL BE FREE ^ 
OPERATOR HAS BEEN NOTIFIED 
IN HALF AN HOUR 
THANK S ^J 
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Function 

The PLOT command places entries in the plotter output queue. 
This command is equivalent to the following form of the QUEUE 
command: 

QUEUE PLT:jobname = list of input specifications 

Command Format 

PLOT jobname = list of input specifications 

jobname is the name of your job being entered into the 
queue. The default is the name of the first file in the 
request, not the name of the first file given. These differ 
when the first file given does not yet exist. 

input specifications is a single file specification or a 
string of file specifications, separated by commas, for the 
disk files being processed. A file specification is in the 
form dev: file. ext [directory] . 

dev: is any disk file structure to which PLTSPL has access; 
the default is DSK: . 

file. ext are names of the files. The file name is optional. 
The default for the first file name is *, the default for 
subsequent files is the last file name used. The extension 
can be omitted; the default is .PLT. 

[directory] is a directory to which you have access; your 
directory is assumed if none is specified. 

You can obtain the listing of entries in the plotter queue for 
specific project-programmer numbers by following the command with 
the desired project-programmer numbers enclosed in square 
brackets (e.g., PLOT [40,15]). If no arguments are given with 
the command (i.e., only the command name is given), the entries 
for all jobs of all users are output. The asterisk wildcard 
convention can be used for the input specifications. Switches 
that aid in constructing the queue entry can appear as part of 
the input specification. These switches are divided into three 
categories: 

1. Queue-operating - Only one of these switches can be placed in 
the command string because the switches define the type of 
queue request. The switch used can appear anywhere in the 
command string. 

2. General - Each switch in this category can appear only once 
in the command string because they affect the entire request. 
The switch used can appear anywhere in the command string. 

3. File control - Any number of these switches can appear in the 
command string because this category is specific to 
individual files within the request. The switch used must be 
adjacent to the file to which it applies. If the switch 
precedes the file name, it becomes the default for subsequent 
files. For example, the command string 

PLOT FILEA,FILEB/DISP:REN,FILEC 
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indicates that the DISPOSE switch is only for FILEB. The 
command string 

PLOT /DISPrREN FILEA, FILEB, FILEC 

indicates that the DISPOSE switch is for all three files. 

The following switches can be used with the PLOT command. Note 
that if you omit an argument to a switch, you must also omit the 
colon preceding the argument. Otherwise, the argument is assumed 
to be zero and not the default value. 

(See the QUEUE command for a complete list of switches and their 
functions. ) 

Characteristics 

The PLOT command: 

Leaves your terminal in monitor mode. 

Runs the QUEUE program, destroying your core image. 

Does not require LOGIN when only QUEUE listings are desired. 

Examples 

* PLOT % * PLT/FORMS I PLAIN S Cause all files with the extension 

. PLT in your area to be plotted. 
Because these are spooled files (i.e., 
have the extension .PLT), the files 
are immediately renamed out of your 
area, and deleted after plotting. The 
operator is asked to put PLAIN paper 
on the plotter. 
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Function 

The PRESERVE command renames the specified files with the 
standard protection (usually 055 to 057) inclusively ORed with 
100. The files are then preserved so that KJOB will not delete 
them unless you request it to. This command has the same action 
as the P argument to the KJOB command when individually 
determining what to do with each file. 

Command Format 

PRESERVE file.ext, f ile2.ext,f ile3.ext, . . . 

You can use the full wildcard construction for either the 
file name or the extension. If you specify a protection 
code, the result of the PRESERVE command is the same as the 
PROTECT command; that is, the given protection code is used 
instead of the standard protection inclusively ORed with 
100. 

Characteristics 

The PRESERVE command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, destroying your core image. 



Example 



♦ PRESERVE TEST.REL ^y 

files renamed: 

TEST.REL 

♦ preserve prog 1 * * *j 
files renamed: 

PR0G1*REL 
PRGG1*G0R 
PR0G1*ALG 
PROG 1. FOR 



1 This command runs the COMPIL program, which interprets the command 
before running PIP. 
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Function 

The PRINT command places entries into the line printer output 
queue. This command is equivalent to the following form of the 
QUEUE command: 

QUEUE LPT:jobname = list of input specifications 

Command Format 

PRINT jobname = list of input specifications 

jobname is the name of your job being entered into the 
queue. The default is the name of the first file in the 
request, not the name of the first file given. These differ 
when the first file given does not yet exist. 

input specifications is a single file specification or a 
string of file specifications, separated by commas, for the 
disk files being processed. A file specification is in the 
form dev:file.ext [directory]. 

dev: is any disk file structure to which LPTSPL has access; 
the default is DSK: . 

file.ext are the names of the files. The file name is 
optional. The default for the first file name is *, the 
default for subsequent files is the last file name used. 
The extension can be omitted; the default is .LPT. 

[directory] is a directory to which you have access; your 
directory is assumed if none is specified. 

You can obtain the listing of entries in the line printer queue 
for specific project-programmer numbers by following the command 
with the desired project-programmer numbers enclosed in square 
brackets (e.g., PRINT [10,157], If you do not specify any 
arguments with the command (i.e., you type only the command name 
), the system prints all entries in the line printer queue for 
all jobs for all users. 

You can use the asterisk wildcard construction for the input 
specification. Switches that aid in constructing the queue entry 
can appear as part of the input specifications. These switches 
are divided into three categories: 

1. Queue-operation - Only one of these switches can be placed in 
the command string because the switches define the type of 
queue request. The switch used can appear anywhere in the 
command string. 

2. General - Each switch in this category can appear only once 
in the command string because they affect the entire request. 
The switch used can appear anywhere in the command string. 

3. File control - Any number of these switches can appear in the 
command string because this category is specific to 
individual files within the request. The switch used must be 
adjacent to the file to which it applies. If the switch 
precedes the file name, it becomes the default for subsequent 
files. For example, the command string 
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PRINT FILEA, FILEB/DISP : REN , FILEC 

indicates that the DISPOSE switch is only for FILEB. The 
command string 

PRINT /DISP:REN FILEA, FILEB, FILEC 

indicates that the DISPOSE switch applies to all three files. 

(See the QUEUE command for a complete list of switches and their 
functions. ) 

Characteristics 

The PRINT command: 

Leaves your terminal in monitor mode. 

Runs the QUEUE program, destroying your core image. 

Does not require LOGIN when only queue listings are desired. 

Examples 

• PRINT NOTICE ♦TXT ^ Print the file DSK:NOTICE.TXT. 

» PRINT SYSTAT ♦ SCM/DISP t RENAME/COPIES 1 *J 

Print two copies of the file 

DSK: SYSTAT. SCM from your default area. 

Rename the file out of your area 

immediately and delete it after 
printing. 

♦ PRINT*. TXT/HEADER :Q/FQRMSt2PART «»> / 

Print all files in your area which have 
the extension .TXT. Do not print file 
headers between the files. Print the 
files on forms known to the operator as 
2 PART . 

♦ PRINT/SEQ*3S6/KILL ^ Remove the request with sequence number 

356 from the LPT queue. This is 
accepted only if the spooler has not 
started processing the request. 

♦ PRINT LOADER .-SAV/QKBINARY/PRINT: SUPPRESS ^ 

Print a file known to be a binary file 
and suppress all carriage control 
characters except CR and LF. 

. PRINT FRGMAC .REL/PRINT X OCTAL ^ 

Print an octal dump of the file 
PRGMAC.REL. 



2-170 



PROTECT Command 1 



Function 

The PROTECT command alters the access protection codes associated 
with the specified files. The action of this command is similar 
to the R switch in PIP. 

You indicate the access protection of a file by three octal 
digits. Each digit represents a particular class of user. The 
first digit represents the owner of the file, the second 
represents users with the same project number as the owner, and 
the third represents all other users. Each number in the 3-digit 
code can be one of the following. 

7 No access privileges 

6 Execute the file 

5 Read and execute the file 

4 Append, read and execute the file 

3 Update, append, read, and execute the file 

2 Write, update, append, read, and execute the file 

1 Rename, write, update, append, read, and execute the 

file 
Change protection, rename, write, update, append, read, 

and execute the file. 

The standard protection is normally 057, which means the owner 
has all privileges (0), users in the owner's project can read and 
execute the file (5), and all other users cannot access the file 
(7). However, the system standard may be changed by the 
individual installations. Note that the owner of a file can 
alter the file's protection regardless of the existing protection 
code. Therefore, codes and 1 for the owner have an equivalent 
action. In addition, because the owner can LOOKUP the file to 
change the protection via a RENAME, codes 7 and 6 are equivalent 
to code 5 for the owner. 

Command Format 

PROTECT file <nnn>, file2 <nnn>, file3 <nnn>,... 

You can specify the protection code before the file name, in 
which case it is the default for subsequent files until you 
change it. You can use the fill wildcard construction for 
either the file name or the extension. 

If you have the required privileges, you can change the 
protection of files not in your directory by specifying the 
desired directory name. If you specify the directory name 
before the file name, it becomes the default for all 
succeeding files specified in this command line. 

If you omit the protection code, the result of the PROTECT 
command is the same as the PRESERVE command; that is, the 
system gives the standard protection code inclusively ORed 
with 100 to the file. 



1 This command runs the COMPIL program, which interprets the command 
before running PIP. 
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Characteristics 

The PROTECT command: 

Leaves your terminal in monitor mode. 

Runs the PIP program, destroying your core image 

Examples 

* p r t e c t t e s t ♦ r e l < 057 > *j 
files renamed: 

TEST*REL 

, p r q t e c t p r g 1 ♦ * < 1 2 3 > ^j 
files renamed: 

PR0G1.REL 
PR0G1.Q0R 
PR0G1 <-ALG 
PROGltFOR 
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Function 

The QUEUE command allows you to make entries in several system 
queues - the input queue for the batch system, and the output 
spooling queues for the line printer, the card punch, the 
paper-tape punch, and the plotter. The QUEUE command also 
provides the means of obtaining listings of the entries in the 
queues. 

Command Formats 

1. QUEUE INP: jobname = control file specification, log file 
specification 

To make an entry in the batch input queue, INP:. 

2. QUEUE output queue name: jobname = list of input 
specifications 

To make an entry in an output spooling queue. 

3. QUEUE listing file specif ications/LIST = list of queue names 

To obtain a listing of the entries in a queue. 

4. The following six commands can be substituted for the various 
formats of the QUEUE command: 

a. CPUNCH jobname = list of input specifications equivalent 
to QUEUE CDP: jobname = list 

b. PLOT jobname = list of input specifications equivalent to 
QUEUE PLT: jobname = list 

c. PRINT jobname = list of input specifications equivalent 
to QUEUE LPT: jobname = list 

d. SUBMIT jobname = control file name, log file name 
equivalent to QUEUE INP: jobname = control file, log 
file 

e. TPUNCH jobname = list of input specifications equivalent 
to QUEUE PTP: jobname = list 

Queue names are taken from the following list: 

INP: (I:) Batch input queue 

LPT: (L:) Line printer output queue, default condition 

CDP: (C:) Card punch output queue 

PTP: (PT:) Paper-tape punch output queue 

PLT: (PL:) Plotter output queue 

Control file specification is the file specification, plus 
switches and keyword parameters, for the control file being 
submitted to the batch input queue. This file can be on any file 
structure that you have access to; the default is DSK:. The 
file name is required, but you can omit the extension; the 
default is .CTL. The asterisk construction is legal for the file 
name or extension and is the only way you can submit multiple 
control files to batch with a single QUEUE command. 
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Log file specification is the file specification for the file 
that is to be used to record action taken during the execution of 
the control file. This file can be in any directory on any file 
structure on which you have privileges to write. The default is 
the same file structure in which the control file resides. If 
the file name is missing, the log file is given the same name as 
the control file. If the extension is omitted, it is .LOG. 

Jobname is the name of your job being entered into the queue. 
The default job name is the name of the first file in the request 
and not the first file given. These names are different when the 
first file given does not yet exist. 

Input specifications are the file specifications for the disk 
files to be processed and the various switches and keyword 
parameters that aid in constructing the queue entry. The files 
can be on any file structure that the queue processor has access 
to; the default is DSK:. The files can be in any directory, 
provided that you have read-access to them; the default is your 
directory. The file name is optional; the default is * for the 
first file name. The default for subsequent file names is the 
last file name used. Note that the asterisk wildcard 
construction is legal only in the input specifications. You can 
omit the extension because each queue has a default extension for 
the files to be processed. These default extensions are: 

.CTL - Batch input queue 

.LPT - Line printer queue 

.CDP - Card punch queue 

. PTP - Paper-tape punch queue 

.PLT - Plotter queue 

The listing file specification is the description of the listing 
file. The default for the listing file destination is TTY unless 
a file name is specified. In this case, the listing goes to the 
disk. The default extension for the queue listing is .LSQ. If 
no queue names are specified, all queues for all the jobs of all 
users are listed. 

You can obtain queue listings for specific project-programmer 
numbers by following the queue name with the desired 
project-programmer numbers enclosed in square brackets (e.g., 
QUEUE/LIST = INP: [27,235], [10,47]). The wildcard construction 
can be used for the project number or programmer number. If no 
queue names are specified but a project-programmer number is 
given, all queues for all jobs of the specified user are listed. 
For example, QUEUE/LIST = [27,400] lists the entries in all 
queues for the user [27,400]. 

Switches - Three categories of switches are provided. The first 
category contains the switches that define the operation; the 
second contains the switches that can appear only once because 
they affect the entire request; the third contains the switches 
specific to each file. In general, switches that precede the 
file name become the default for all succeeding files. This is 
true also for a device name, an extension, or a directory name 
that precedes a file name. 

Queue-Operation Switches - Only one of this type of switch can be 
placed in a command string, because these switches define the 
type of queue request. This switch may appear anywhere in the 
command string. 
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General Queue Switches - Each of these switches can appear only 
once in a command string. They affect the entire request, 
generally in terms of scheduling. These switches can appear 
anywhere in the command string. 

File-Control Switches - These switches affect the individual 
files in a request and must be adjacent to the file name in the 
command string. In order to change the defaults for the rest of 
the files, however, these switches must appear before a file 
name. For example, the command string 

QUEUE FILEA,FILEB/DISP:REN,FILEC 

indicates that the DISPOSE switch will affect only FILEB. The 
command string 

QUEUE /DISP:REN FILEA, FILEB, FILEC 

indicates that the DISPOSE switch applies to all three files. 

In the table of switches below, the following conventions have 
been used: 

ALL - Switches that can appear for both the batch input 
queue and the output queues. 

INPUT - Switches that can appear only for the batch input 
queue. 

LIST - Switches that can appear only for the listing file 
specification. 

OUTPUT - Switches that can appear only for the output 
queues. 

Note that if you omit an argument to a switch, you must also omit 
the colon preceding the argument. Otherwise, the argument is 
assumed to be zero and not the default value. 



Switch 
/AFTER: t 



/BEFORE :t 



/BEGIN :n 



Category 
General 



General 



File 
Control 



Queues 



ALL 



OUTPUT 



OUTPUT 
(LPT) INPUT 



Meaning 



Process the request after the 
specified time. t is in the 
form hh:mm (time of day) or 
+hh:mm (time later than the 
current time) . A colon must 
be used to separate the hours 
from the minutes. The 
resulting AFTER time must be 
less than the DEADLINE time. 
If the switch or the value of 
the switch is omitted, no 
AFTER constraints are assumed. 

Queue only the files with 
creation dates before time t 
where t = dd-mmmm-yy: hh:mm. 
Date must be today or earlier. 

Start the output on the nth 
page for LPT requests or on 
the nth line of the control 
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Switch 



Category Queues 



Meaning 



file for INP: requests. The 
default is to begin output on 
the first unit. 



/CARDS : n 



General INPUT 



/COPIES :n 



File 
Control 



OUTPUT 



/CORE : n 



General 



INPUT 



/CREATE 



/DEADLINE :t 



Queue ALL 
Operation 



General ALL 



Use n (decimal) as the maximum 
number of cards that can be 
punched by your job. If the 
switch is omitted, no cards 
are punched. If the switch is 
given with no value, 2000 
cards is assumed as the 
maximum. 

Repeat the output the speci- 
fied number of times (n must 
be less than 64) . The default 
is one copy. If more than 63 
copies are desired, two (or 
more) requests must be made. 

Use n (in decimal K) as the 
maximum amount of core memory 
that your job can use. If the 
switch is omitted, a maximum 
of 25K is assumed; if the 
value of the switch is 
omitted, a maximum of 40K is 
assumed. 

Make a new entry in the speci- 
fied queue. This switch is 
the default for the 
queue-operation switches. 

Process the request before 
specified time. t is in the 
form hh:mm (time of day) or 
+hh:mm (time later than the 
current time) . A colon must 
be used to separate the hours 
from the minutes. The 
resulting DEADLINE time must 
be greater than the /AFTER 
time. If the switch or the 
value of the switch is 
omitted, no DEADLINE 
constraints are assumed. 



/DELETE 



/DEPEND :n 



File ALL 
Control 

General INPUT 



Same as /DISPOSE. 



Specifies the initial value of 
the dependency count in 
decimal. When used with 
/MODIFY, this switch changes 
the dependency count of 
another job. If n is a signed 
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Switch 



Category Queues 



Meaning 



number (+ or -) , that number 
is added to or subtracted from 
the dependent job's count. If 
n is not a signed number, the 
dependent job's count is 
changed to n. If this switch 
is omitted, no dependency is 
assumed. 



/DISPOSE: 
DELETE 

/DISPOSE: 
PRESERVE 



/E RBI NARY 



/ERNONE 



File 
Control 

File 
Control 



ALL 



ALL 



Delete the 
spooling. 



file 



after 



Save the file after spooling. 
This is the default for all 
files except those with 
extensions of .LST. 

Type an error message if 
binary file is included in the 
queue. 

Type an error message if no 
files match the wildcard 
construction. 



/ERPROTECTION 



Types an error message if a 
violation of protection fields 
would be required to process 
the command. 



/F 



Queue LIST 
Operation 



/FEET:n 



General 



INPUT 



/FILE -.ASCII File INPUT 
Control 



List the entries in the queue, 
but do not update the queues. 
Therefore, the list may not be 
an up-to-date listing of the 
queues but the listing will be 
faster than with /LIST. 

Use n (in decimal) as the 

maximum number of feet of 

paper tape that your job can 

punch. If the switch is 

omitted, no paper tape is 

punched. If the value is 

omitted, the default is 10* 

B+20 feet, where B is the 

number of blocks in the 
request. 

Specify that the INPUT file 
format is to be interpreted as 
ASCII text. This is assumed 
for all files with extensions 
other than .DAT. 



FILE: COBOL 



File 
Control 



INPUT 



Specify that the INPUT file 
format is to be interpreted as 
COBOL SIXBIT text. 



/FILE: ELEVEN 



File 
Control 



INPUT 



Specify that the INPUT file 
format is to be interpreted as 
four 8-bit bytes in each 
36-bit word. These bytes are 
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Switch 



Category Queues 



Meaning 



arranged as follows: 1st byte 
is in bits 10-17; 2nd byte, 
in bits 2-9; 3rd byte, in 
bits 28-35; 4th byte, in bits 
20-27. 



/FILE: FORTRAN File 

Control 



INPUT 



/FORMS : a 



/HEADER: 
or 1 



General 



OUTPUT 



File OUTPUT 
Control 



Specify that the INPUT file 
format is to be interpreted as 
FORTRAN ASCII text (obeys 
FORTRAN control characters). 
This is assumed if you specify 
the extension .DAT explicitly. 

Place the output on the named 
forms. The argument to the 
switch must be six 
alphanumeric characters. 
Normal forms (14 x 11) are 
used if this switch is 
omitted. Narrow forms are 8 
1/2 x 11. 

Output block headers at begin- 
ning of the file if 1 
(default) ; do not output 
headers if 0. 



/HELP or 
/HELP: TEXT 



/HELP: 
SWITCHES 



Print a message giving the 
general format of the command 
string and explain the 
dialogue that is entered if 
you need additional help. 

Type out a list of switches. 



/KILL 



Queue ALL 
Operation 



Remove the speci 
from the specifi 
This switch require 
specification; it 
default to LPT:*, 
switch can be 
deleting a 
submitted request a 
the request has 
started. 



fied entry 

ed queue. 

s an output 

does not 

The /KILL 

used for 

previously 

s long as 

not been 



/LIMIT: n 



/LIST 



/L:ALL 



General OUTPUT 



Queue LIST 
Operation 



Queue LIST 
Operation 



Limit the output to the 
specified number of pages, 
cards, feet, or minutes. (One 
page is about three blocks.) 

List the specified entries in 
the queue; the default 
entries are those for queues 
for all the jobs of all users. 

List all data on each queue 
request. 
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Switch 



Category Queues 



Meaning 



/L: DETAIL 


Queue 
Operation 


LIST 


/L:FAST 


Queue 
Operation 


LIST 


/L: FILES 


Queue 
Operation 


LIST 


/L:JOBS 


Queue 
Operation 


LIST 


/LOG 


File 
Control 


OUTPUT 
(LPT) 


/METERS :n or 
/METRES :n 


General 


OUTPUT 


/MODIFY 


Queue 
Operation 


ALL 



/NEW 



File 
Control 



ALL 



/NOHEADER 


File 
Control 


OUTPUT 


/NOLOG 


File 
Control 


OUTPUT 


/NONEW 


File 
Control 


ALL 


/NONULL 


General 


OUTPUT 


/NOOPTION 


General 


OUTPUT 


/NOPHYSICAL 


File 
Control 


OUTPUT 


/NOREMOVE 


File 
Control 


OUTPUT 



List detailed job data on each 
queue request. 

Same as /FAST. 



List the files in each queue 
request. 

List jobs in the queue. 



Define the file that the 
spoolers will use to record 
their output. The default is 
jobname LOG. 

Limit PTP-limit to n meters. 



Alter the spec 
in the specifi 
switch requir 
access rights 
also requires 
it does not 
LPT. This sw 
to modify 
submitted req 
the request 
started. 



ified parameters 
ed jobs; this 
es that you have 
to the job. It 
a queue name; 
default to the 
itch can be used 
a previously 
uest as long as 
has not been 



Accept request even if file 
does not yet exist. This is 
the default for the log file 
of batch input queue. 

Suppress the block headers at 
the beginning of the file. 

This is not to be the job's 
log file. 

This file already exists. 



Print an error message on a 
null request. 



Suppress the option 
SWITCH.INI. 



file 



Allow logical names in a 
LOOKUP. 

Do not remove a file from the 
queue. 
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Switch 


Category 


Queues 


/NORESTART 


General 


INPUT 


/NOSTRS 


File 
Control 


OUTPUT 


/NOTE : a 


General 


OUTPUT 


/NOTITLE 


File 
Control 


OUTPUT 


/NOUNPRE 


General 


OUTPUT 


/NULL 


General 


OUTPUT 



Meaning 



Job cannot be restarted if 
your job was stopped because 
of an error. 

Do not scan each structure for 
files with the same name. 

Output the specified text (a) 
in the output. 

Do not add a title to each 
page. 

The /NOUNPRESERVE switch 
allows any file to be output. 

Do not output an error message 
if there are no files in the 
request and do not create a 
queue entry. This is assumed 
at KJOB time. 



/OKBINARY 



/OKNONE 



File 
Control 



File 
Control 



OUTPUT (LPT) 



OUTPUT 



Print files whose extensions 
include binary information. 
Normally files with extensions 
.SAV, .SHR, .LOW, .REL f and 
.HGH will not be in print 
queues. 

Do not produce message if no 
files match the wildcard 



construction, 
totally null 
produces a 
message. 



However, a 

queue request 

fatal error 



/OKPROTECTION General ALL 
/OPTION :S General ALL 



Ignore all protection errors. 

Use the option line QUEUE :S in 
the SWITCH.INI file. 



/OUTPUT :n 



General 



INPUT 



.LST files 
deferred 
(default) . 



and any requests 
to LOGOUT time 



/PAGE : n 



General 



OUTPUT 



/PAPER: x 


File 
Control 


OUTPUT 


/PARITY: 
EVEN or ODD 


File 
Control 


ALL 


/PATH. [DIR] 


File 
Control 


OUTPUT 



Use n (decimal) as the maximum 
number of pages of output that 
your job can print. If the 
switch is omitted, the maximum 
is 200 pages; if only the 
value is omitted, a maximum of 
2000 pages can be printed. 

Identical to /PUNCH:x., 
/PRINT: x, /TAPE:x, or /PLOT:x. 

List the tape with either EVEN 
or ODD parity. 

Run the job in the default 
directory. 
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Switch 


Category 


/PHYSICAL 


File 
Control 


/PLOT: ASCI I 


File 
Control 



/PLOT: BINARY 



/PLOT: IMAGE 



File 
Control 



File 
Control 



Queues 



ALL 



OUTPUT (PLT) 



OUTPUT (PLT) 



OUTPUT (PLT) 



Meaning 



Suppress logical device names 
for the specified device. 

Plot the file in ASCII mode. 
If the /PLOT switch is 
omitted, the file is plotted 
in the data mode specified in 
the file. 

Plot the file in binary mode. 
If the /PLOT switch is 
omitted, the file is plotted 
in the data mode specified in 
the file. 

Plot the file in image mode. 
If the /PLOT switch is 
omitted, the file is plotted 
in the data mode specified in 
the file. 



/PRESERVE 
/PRINT: ARROW 

/PRINT: ASCI I 
/PRINT: OCTAL 



/PRINT: 
SUPPRESS 



/PRIORITY 2 n 



File 
Control 



General 



/PROTECT :nnn General 



OUTPUT (LPT) 



File 
Control 


OUTPUT 


(LPT) 


File 
Control 


OUTPUT 


(LPT) 


File 
Control 


OUTPUT 


(LPT) 



ALL 



ALL 



Convert all control characters 
to up-arrow format except 
011-015 and 020-024. This is 
the default. 

Send the file to the line 
printer with no changes. 

Print the file in octal. 



Convert all carriage-control 
characters to line-feeds 
except for ASCII code 
characters and CR and DC3; 
this switch implies the use of 
the /PRINT:ARROW. Equivalent 
to operator command to spooler 
(SUPPRESS) . 

Give the specified external 
priority (n = to 62) to the 
request. A larger number is 
greater priority. The default 
is 10 if no switch is given, 
and 20 if a switch is given 
without the value. 

Specify a protection nnn (in 
octal) for this job or queue 
entry. If the switch or the 
value of the switch, is 
omitted, the standard 
protection is assumed. 
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Switch 



Category Queues 



Meaning 



/PUNCH: 026 File OUTPUT (CDP) 
Control 



Punch files in 026 Hollerith 
code. If the /PUNCH switch is 
not given, the files are 
punched according to the data 
mode of the file. 



/PUNCH:ASCII File OUTPUT (CDP) 
Control 



Punch files in ASCII card 
code. If the /PUNCH switch is 
not given, the files are 
punched according to the data 
mode of the file. 



/PUNCH:BCD File OUTPUT (CDP) 
Control 



Same as /PUNCH: 026. 



/PUNCH: 
BINARY 



File OUTPUT (CDP) 
Control 



Punch files in check-summed- 
binary card format. If the 
/PUNCH switch is not given, 
the files are punched 
according to the data mode of 
the file. 



/PUNCH: IMAGE File OUTPUT (CDP) 
Control 



Punch files in image card 
format. If the /PUNCH switch 
is not given, the files are 
punched according to the data 
mode of the file. 



/PUNCH: 
MNEMONIC 



File 
Control 



OUTPUT (CDP) 



Punch files in mnemonic binary 
Mode. If the /PUNCH switch is 
not given, the files are 
punched according to the data 
mode of the file. 



/REMOVE 



File 
Control 



OUTPUT 



/REPORT: code 



/RESTART: 
or 1 



File 
Control 



General 



OUTPUT (LPT) 



INPUT 



Remove the file from the 
queue. This switch is valid 
only with the /MODIFY switch 
and can be used to remove a 
previously submitted file as 
long as the batch system has 
not started processing your 
job. 

Prints the specified report 
cover page and up to one 
additional page within a COBOL 
report file. Code can be up 
to 12 characters in length. 

A value of (default) means 
the job cannot be requeued or 
restarted by the operator 
after a system crash. A 
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Switch 



Category Queues 



Meaning 



/RUN: file 
/RUNCORE : n 
/RUNOFFSETtn 
/SEQUENCE :n 

/SINCE: t 



/SPACING; 
DOUBLE 

/SPACING: 
SINGLE 

/SPACING: 
TRIPLE 



/STRS 



/TAG: xxx 



/TAPE: ASCI I 



File 
Control 

File 
Control 

File 
Control 

General 



General 



File 
Control 

File 
Control 

File 
Control 

File 
Control 



File 
Control 



File 
Control 



OUTPUT 
OUTPUT 
OUTPUT 
ALL 

OUTPUT 

OUTPUT (LPT) 

OUTPUT (LPT) 

OUTPUT (LPT) 
OUTPUT 



INPUT 



OUTPUT (PTP) 



message is sent to the job's 
log file. A value of 1 means 
the job will be requeued or 
restarted. Your job should 
not be restarted if there are 
changes to the permanent file 
directory. 

Execute the specified file. 



Execute the specified file in 
nK or core. 

Execute the specified file 
with offset n. 

Specify a sequence number to 
aid in identifying a request 
to be modified or deleted. 

Queue only the files with 
creation dates after the 
specified time t where t is in 
the form dd-mmm-yy hh:mm. 

Double-space the output lines. 



Single-space the printed lines 
(default) . 



Triple-space 
lines. 



the 



printed 



Search for the file on all 
structures in the search list 
and take each occurrence. The 
default is to take just the 
first occurrence of the file. 

Start at the statement labeled 
xxx of the control file. 
Equivalent to GOTOxxx at the 
beginning of the control file. 

Punch the tape in ASCII code. 
If the /TAPE switch is not 
specified, the files are 
punched according to the data 
mode of the file. 
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Switch 



Category Queues 



Meaning 



/TAPE: BINARY File 

Control 



/TAPE:IBINARY File 

Control 



/TAPE: IMAGE File 

Control 



OUTPUT (PTP) 



OUTPUT (PTP) 



OUTPUT (PTP) 



Punch the tape in binary mode. 
If the /TAPE switch is not 
specified, the files are 
punched according to the data 
mode of the file. 

Punch the tape in image-binary 
mode. If the /TAPE switch is 
not specified, the files are 
punched according to the data 
mode of the file. 

Punch the tape in image mode. 
If the /TAPE switch is not 
specified, the files are 
punched according to the data 
mode of the file. 



/TIME: 
hh:mm: ss 



General 



INPUT 



Specify the central processor 
time limit for your job. A 
colon must be used to separate 
the hours, minutes, and 
seconds. If no switch is 
specified, the limit is 5 
minutes; if the switch is 
specified without a value, the 
limit is 1 hour. 



/TITLE 
/TPLOT:n 



File 


OUTPUT 


Control 




General 


INPUT 



/UNIQUE: 
or 1 



General 



INPUT 



/UNPRESERVED General 



OUTPUT 



Print a 
output. 



title on each page of 



Use n (decimal minutes) as the 
maximum amount of plotting 

time allowed for your job. If 

the switch is omitted, no 

plotter time is allowed; if 

the value is omitted but the 

switch is specified, the 

maximum plotter time is 10 
minutes. 

Run any number of batch jobs 
under this project-programmer 
number at the same time, if 0. 
Runs only one batch job at any 
one time, if 1 (default). 



Output file only 
preserved. 



if 



not 



Characteristics 

The QUEUE command (and its associated variations) : 

Leaves your terminal in monitor mode. 

Runs the QUEUE program, thereby destroying your core image. 

Does not require LOGIN when only queue listings are desired. 
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Examples 

. QUEUE FILEA yFILEB^ 

, QUEUE inp:=test^ 

♦ QU EUE IN:PAYR«MAN^ 

* QUEUE DSK t A ♦ X •-"/!- I ST -^ 

. QUEUE INP S FREEO"FILEA/CREATE 
/PRIORITY? 4/ TIME? 1 i 5 ^J 



♦ QUEUE INP J TESTS/KILL^ 



Enter file FILEA.LPT and 

FILEB.LPT in the line-printer 

queue under the job name of 
FILEA. 

Enter file TEST.CTL in the batch 
input queue under jobname TEST 
and log file with name TEST. LOG. 

Enter file MAN.CTL in the batch 
input queue under jobname PAYR 
and log file with name MAN. LOG. 

Place a queue listing of all 
jobs into file A.X in your disk 
area. 

Place file FILEA. CTL in the 
Batch input queue with the job 
name FREED. An external 
priority of 4 and CPU time limit 
of one minute and five seconds 
are set for your job. The log 
file is named FILEA.LOG. 

Remove the entry corresponding 
to TEST.CTL from the batch input 
queue. 



♦ QUEUE INP: JQBNAH=*/H0DIFY/TIi1ES2S00^ 



Alter the time parameter of the 
entry corresponding to 
JOBNAM.CTL in the batch input 
queue. 



♦ QUEUE INP : = JOB . CTL/PAGES J 500/TPLOY \ 12*J 



♦ QUEUE PLT i « JOB * PLT/L I M I T i 20^ 



Establish a limit of 500 pages 
and 20 minutes of plotting on 
the output generated by this 
job. 

Queue a file to PLTSPL with a 
limit of 20 minutes of plotting 
time. 
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Function 

The QUOLST program informs you of both the amount of disk space 
you have used and the amount you have left on each file structure 
in your search list. This program also returns the amount of 
free space that the system has left for all users of the 
structure. Free system space on structures not in your search 
list is not output. You can obtain this information by typing 
SYSTAT/F. 

The output given for each file structure consists of 1) the 
structure name; 2) the number of blocks allocated; and 3) the 
number of blocks left in the logged-in quota, in the logged-out 
quota, and on the structure. The number of blocks allocated is 
the same as the number output in the summary of the DIRECT 
command when the /ALLOC switch is used. 

Note that the QUOLST program does not return statistics for a 
user logged-in under [1,2] because this project-programmer number 
has infinite quotas. 

Command Format 

R QUOLST 

Characteristics 

The R QUOLST command: 

Leaves the terminal in monitor mode. 

Runs the QUOLST program, destroying your core image. 



Examples 










♦ R QUOL 


.ST*^ 








USER t 


27 > 4072 








STR 


USED 


LEFT KIN) 


( OUT ) 


(SYS) 


DSKAJ 





1000 


100 


1388 


DSKC t 


245 


9755 


4755 


12916 


dskb: 


50 


9950 


4950 


92448 
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Function 

The R command loads a core image from the system device (SYS:) 
and starts it at the location specified within the file (.JBSA in 
the Job Data Area). This command is the same as RUN SYS:file.ext 
core and is the usual way to run a system program that does not 
have a direct monitor command to run it. 

This command clears all of user core. However, programs should 
not count on this action and should explicitly clear those areas 
of core that are expected to contain zeros (i.e., programs should 
be self-initializing). This action allows programs to be 
restarted by a CTRL/C, START sequence without having to do 
another R command. Note that if a directory specification should 
be present in the command string, it overrides the assumed SYS: 
device. 

On magnetic tape, if the low or high segment is missing, a null 
record is output before the EOF for the missing segment so that 
two EOFs cannot occur consecutively. Therefore, a saved null 
segment does not appear as a logical EOT (TWO EOFs in a row) . 

Command Format 

R file.ext core 

Arguments are the same as in the RUN command except that 
SYS; is used as the default device. (In nondisk monitors, 
the default is the generic name that matches the system 
device.) (Refer to the RUN command for a discussion of the 
core argument. ) 

The extension applies to the low file, not the high file. 
An extension of .SHR, then .HGH, is assumed for the high 
file. If the user types an extension of .SHR or .HGH, the 
extension is treated as a null extension because .SHR and 
.HGH are confusing as low file extensions. 

Characteristics 

The R command: 

Places the terminal is user mode. 

Runs a system program, destroying your core image. 

Examples 



* R PIP '5 ^J 
* 
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Function 

The REASSIGN command allows one job to pass a device to a second 
job without having the device go through the monitor device pool 
(restricted or unrestricted). Both restricted and unrestricted 
devices can be reassigned. This command, applied to DECtapes, 
clears the copy of the directory currently in core, forcing the 
next directory reference to read a new copy from the tape, but 
does not clear the logical name assignment. If a device is 
INITed, a RELEASE UUO is performed unless the user issuing the 
command is reassigning the device to himself. 

Command Format 

REASSIGN dev job 

dev = the physical or logical name of the device to be 
reassigned. This argument is required. 

job = the number of the job to which the device is to be 
reassigned. If no job is specified, the device is 
reassigned to the job issuing the command. This is useful 
when you want to force the next directory reference to come 
from the tape instead of core. 

A logical name that is also a physical name can be 
reassigned only if the job issuing the command and the job 
to which the device is to be reassigned have the same 
project-programmer number, or the user issuing the command 
has operator privileges (logged-in under [1,2] or logged-in 
at OPR) . However, a logical name cannot be duplicated; 
because, two devices cannot have the same logical name. 

Characteristics 

The REASSIGN coammand: 

Leaves the terminal in monitor mode. 

Requires core. 

Will not operate while a device transmits data. 

Restrictions 

The job's controlling terminal cannot be reassigned. 

Examples 

« REASSIGN LPT i 1 7 ^J Reassign the line printer to job 17. 

♦ REASSIGN CDPM ^ Reassign the card punch to job 4. 



2-188 



REATTA Program 



Function 

The REATTA program allows you to transfer your job from one 
terminal to another. Unlike the ATTACH command, REATTA does not 
require a password or that the terminal be of the same type that 
LOGIN recognizes in order to run the job. For example, usually a 
[1,2] job can run only on a local terminal. However, the REATTA 
program can be used to attach a [1,2] job from a local terminal 
to a remote terminal. 

Before reattaching your job, you should verify that the terminal 
to which you are attaching is turned on and working properly. 
Otherwise, it might be difficult to retrieve the job. 

Command Format 

.R REATTA 

REATTA responds by asking for the new terminal name. 

TYPE NEW TTY NAME: 

The user answers with either the new terminal name (e.g., 
CTY, TTY2) or number (e.g., 2). REATTA then responds with 

FROM JOB n 
on the old terminal, and 

NOW ATTACHED TO JOB n 
on the new terminal. 

Characteristics 

The R REATTA command: 

Leaves the terminal in monitor mode. 

Runs the REATTA program, thereby destroying your core image. 

Restrictions 

The R REATTA command is not available to batch users. 

Examples 

« R REATTA *J 

TYPE NEW TTY NAME J TTY27 ; appears on old terminal 

FROM JOB 7 

» 

NOW ATTACHED TO JOB 7 ; appears on TTY 27 
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Function 

The REENTER command restarts a program at a location prespecified 
in the program as an alternate entry point. Although the use of 
this alternate entry point varies among programs, it is 
frequently used for a partial reinitialization of the program. 
(The START command is used for a complete reinitialization and 
the CONTINUE command is used for no reinitialization.) Note that 
the DDT command resembles the REENTER command because it also 
restarts the program at an alternate entry point. However, this 
point is fixed because it is the beginning address of DDT. 

The REENTER command copies the saved program counter value from 
. JBPC in .JBOPC and starts the program at an alternate entry 
point specified in .JBREN (must be set by the user or his 
program) . If the job was executing a UUO when it was interrupted 
(i.e., in exec mode but not in TTY input wait or SLEEP mode), the 
monitor continues the job until the UUO is completed and then 
traps to the REENTER address in .JBREN. If the job is in TTY 
input wait or SLEEP mode, the trap to the REENTER address occurs 
immediately and .JBOPC contains the address of the UUO. If the 
job is in user mode, the trap also occurs immediately. 
Therefore, it is always possible to continue the • interrupted 
program after trapping by executing a JRSTF@. JBOPC. 

Command Format 

REENTER 

Characteristics 

The REENTER command: 

Places the terminal in user mode. 

Requires core. 

Requires you to have a job number. 

Example 

♦REENTER 
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Function 

The RENAME command changes one or more items of the file 
specification of files on disk or DECtape. 

Command Format 

RENAMEnewl = oldl, new2 = old2,... 

If the new file name is specified without an extension, the 
null extension is assumed. Device or file structure names 
can be specified only with the new file name and remain in 
effect until changed or until the end of the command string 
is reached. In addition, a protection may be specified with 
the new file name and remains in effect only for that file 
name. This command accepts the full wildcard construction. 

Characteristics 

The RENAME command; 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying your core image. 



Example 



♦ RENAME TEST.REL™R 
TESTER 

files rename: 

? no file name dsk: tester 

♦ rename tester«test ♦ rel 
FILES renamed: 

TEST* REL 

♦ RENAME WONDER ♦ *~PROGi ♦ * 

FILES renamed: 

PROG 1. REL 
PR0G1.Q0R 
PROGiUALG 
PROG !♦ FOR 



This command runs the COMPIL program, which interprets the command 
before running PIP. 
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Function 

The RESOURCES command prints the name of all available devices 
(except TTYs and PTYs) , all file structures, and all physical 
units not in file structures (unless they are down or 
nonexistent) . 

Command Format 

RESOURCES 

Characteristics 

The RESOURCES command: 



Leaves the terminal in monitor mode. 
Does not require LOGIN. 



Example 



♦ RESOURCE 

D I RS » DSKA t WHTV f PCS y WRSO t DSKN t YEI...B r DSKC t GALO t HOUK r DSKB r FSA3 f RPAO y RPA1 tltR 

PR 

PA4 y RPA5 y RPA6 y RPA7 y DPAl r DPA4 y DPA5 y DPA6 y RPB4 y RPB5 1 RPB6 y RPB7 y RPC1 y RPC3 y RPO 

y CDR260 y PTR260 1 DTA262 y 263 y 264 ? 265 y 266 , 267 y MTA260 y 261 y MTB263 y MTC260 y MTD20 
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Function 

The REWIND command rewinds a magnetic tape or a DECtape. This 
command is equivalent to the PIP command string: 

dev: (MW)= 

Command Format 

REWIND dev: 

dev: = a magnetic tape (MTAn) or a DECtape (DTAn) . 

Characteristics 

The REWIND command: 

Leaves the terminal in monitor mode. 

Runs the COMPIL program, thereby destroying your core image. 

Excimples 

♦REWIND DTA014: 
♦REWIND MTAOli: 
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Function 

The RUN command loads a core image from a retrievable storage 
device and starts at the location specified within the file 
(.JBSA) . 

If the program has two segments, both the low and high segments 
are set up. If the high file has extension .SHR (as opposed to 
.HGH) , the high segment will be shared. Therefore, if the user 
RUNs (or GETs) the same program, I/O will not usually be required 
for the high segment. A two-segment program may have a low file 
extension (.LOW). 

The RUN command clears all your core. However, programs should 
not count on this action and should explicitly clear those area 
of core that are expected to contain zeros (i.e., the programs 
should be self-initializing) . This action allows programs to be 
restarted by a "C , START sequence without having to do another 
RUN command. 

On magnetic tape, if the low or high segment is missing, a null 
record is output before the EOF for the missing segment so that 
two EOFs cannot occur consecutively. Therefore, a saved null 
segment does not appear as a logical EOT (TWO EOFs in a row) . 

Command Format 

RUN dev:file.ext [directory] core 

dev: = the logical or physical name of the device containing 

the core image. The default device name is DSK:. (In 

nondisk monitors, the default is the generic name that 
matches the system device.) 

file.ext = the name of the file containing the core image; 
.ext applies to the low file, not the high file. An 
extension of .SHR, then .HGH, is assumed for the high file. 
If the user types an extension of .SHR or .HGH, the 
extension is treated as a null extension because .SHR and 
.HGH are confusing as low file extensions. The default file 
name is the job's current name as set by the last R, RUN, 
GET, SAVE, or SSAVE command, the last SETNAM UUO, or the 
last command which ran a program. 

[directory] = the directory name, required only if core 
image file is located in a disk area other than yours. Note 
that if a directory specification should be present in the 
command string, and the device is SYS: it overrides the 
assumed SYS: device. 

core = the amount of core to be assigned to the sum of the 
low and high segments if different from minimum core needed 
to load the program or from the core argument of the SAVE 
command which saved the file. 

If core > the minimum low segment size, then an error 
message occurs. 

If core > the minimum low segment size and the sum of the 
high segment and the minimum low segment size, then the core 
assignment is the low segment size. 
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If core > the sum of the minimum low segment and the high 
segment size, then the core assignment is the size of both 
the low and high segments to be used. 

Core arguments can be specified in units of 1024 words or 
512 words (a page) by following the number with K or P, 
respectively. For example, 2P represents 2 pages or 1024 
words. If K or P is not specified, K (1024 words) is 
assumed. 

Note that on KA10 based systems (DECsystem-1040, 1050, 
1055), the minimum unit of allocation is 1024 words. 
Therefore, all arguments are rounded to the nearest multiple 
of 1024 words (e.g., 3P is treated as 2K on a KA10 based 
system) . 

Because previous core is returned, MTA must have the core 
argument because there is no director telling how much core 
is for the low segment. (Refer to Appendix D.) 

Characteristics 

The RUN command: 

Places the terminal in user mode. 

Restrictions 

On systems with a large amount of core memory, you should not 
specify a core argument that forces the high segment to start 
higher than 400000 (i.e., a core argument of greater then 128K) 
unless the program's high segment is location independent. If 
this is done, the ILLEGAL UUO error message is likely to occur. 

Examples 

♦ RUN TEST ^y 

» R [J N II I T E S T < 27 > 77 7 '7 ' > «. J 

* RUN DTA013iTEST.t^y 



2-195 



SAVE Command 



Function 

The SAVE command function is determined in the process of 
building the monitor. SAVE can be made identical to either OSAVE 
or NSAVE. 

Example 



MONGEN 





M.EXE = 


M.EXE = 1 


SAVE 


OSAVE 
not shared 
.SAV, .HGH, .LOW, .SHR 


NSAVE 
not shared 
.EXE 


SSAVE 


OS SAVE 

shared 

.SAV, .HGH, .LOW, .SHR 


NSSAVE 

shared 

.EXE 
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Function 

The SCHED command types out the schedule bits as set by the 
operator. You can obtain this information to determine the use 
of the system (e.g., regular timesharing or batch jobs only) 
before you LOGIN. The schedule bits are as follows: 

regular timesharing. 

1 no further logins allowed except from CTY. 

2 no further logins from remote terminals, and no 
answering of data sets. 

4 batch jobs only. 
100 device mounts can be done without operator intervention. 
200 unspooling allowed. 
400 no operator coverage. 

Command Format 

SCHED 

Characteristics 

The SCHED command: 

Leaves the terminal in monitor mode. 
Does not require LOGIN. 



Example 



000000 



000400 



Regular timesharing, but no operator 
coverage. 



000003 



No LOGINs allowed from local or remote 
terminals and data sets are not answered. 



000500 



Regular timesharing, but no operator 
coverage. Device mounts can be done without 
operator interventions. 
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Function 

The SEND command provides a mechanism for one-way interconsole 
communication. (This command replaces the TALK command.) A line 
of information is transmitted from one terminal to another, with 
the identification of the terminal sending the information. With 
remote communications capabilities, SEND is able to differentiate 
between stations. 

When the SEND command is sent from the central operator's 
terminal (OPR) or from a terminal logged in as [1,2], it allows a 
broadcast of a line of information to all non-slaved terminals 
(including remote terminals) in the system. This allows 
important information to be dispersed, such as system shutdown or 
hardware problems. SEND ALL messages do not go to slaved 
terminals unless the SET TTY NO GAG bit is set to permit 
reception when the terminal is busy. 

A busy test is made on single-destination messages before the 
message is sent unless the sender or the receiver of the message 
is OPR or a job logged-in as [1,2]. The receiver of the message 
is considered busy if their terminal is not at monitor command 
level. If the receiver is busy, the sender received the message 
BUSY and the information is not sent, unless the receiving 
terminal has the TTY NO GAG bit set. (Refer to the SET TTY 
command.) If the receiving terminal is turned off, the 
information appears to have been sent, because the hardware 
cannot detect this condition on hard-wired terminals. 

Command Formats 

1. SEND dev:text 

2. SEND JOB n text 

3. SEND m:text 

dev = any physical terminal name (CTY included) or OPRnn. 
If OPRnn is specified, the message is sent to the operator 
at station nn. If OPR (nn is null) is specified, the 
message is sent to the operator at your logical station. If 
the terminal sending the message is the operator's terminal, 
the argument may be ALL to provide the broadcast operation. 

n = the job number to which the message is to be sent. 

m = the number of TTY. 

the message printed on the receiving terminal appears as follows: 

; ;TTYn: - test 

where: 

n is the TTY sending message, and the text is the 
message. A bell sounds on the receiving terminal when 
the message is sent. 
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Characteristics 

The SEND command: 

Leaves the terminal in monitor mode. 
Does not require LOGIN 

Restrictions 

The SEND command is not available to the batch user. 

Examples 

♦ SEND OPJ please write-enable DTA 003 j^y 
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Function 

The SET BLOCKSIZE command sets a default blocksize (in words) for 
the specified magnetic tape. 

Command Format 

SET BLOCKSIZE dev:nnnn 

dev: = MTAnrwhere n is the number of the magnetic tape drive 
for which the blocksize is to be set, or a logical name 
associated with a physical magnetic tape. You must have the 
magnetic tape assigned to you. This argument is required. 

nnnn = a decimal number between 3 and 4094 designating the 
block size for this magnetic tape. No additional checking 
is done for the legality of the specified number besides the 
check for the maximum 4094 and a minimum of 3. This 
argument is required. 

Characteristics 

The SET BLOCKSIZE command: 

Leaves the terminal in monitor mode. 
Examples 

* S E T B I... C K S I Z E M T A 2 t 3 9 5 6 *J 

. ASSIGN MTAOCMtNAMEt ^V 
MTA004 ASSIGNED 

♦ S E T B L C K S I Z E N A M E J 2 *J 
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Function 

The SET BREAK command is used (Kill) and KL10 processors only) 
primarily during the debugging process. It is primarily useful 
when the program which is being debugged: 

1. Will not fail when DDT has been loaded 

2. Destroys DDT when DDT is loaded 

3. Destroys the contents of a memory location at an 
unpredictable point during program execution 

It is possible to break when the specified location is read from, 
written into, and/or fetched. It is also possible to break on 
monitor references to items in the user's address space. This is 
useful when the monitor is storing or retrieving arguments 
to/from unexpected locations in your address space because of 
malformed UUO argument lists. 

If you are breaking on a WRITE condition, the write condition 
causing break will not yet have been executed. Therefore, the 
instruction located at PC and all operands should be examined 
before continuing program execution. 

Command Format 

SET BREAK AT adr ON condition 

SET BREAK NO condition 

SET BREAK NONE 

SET BREAK USERS * 

SET BREAK NO USERS 1 

where: AT and ON are optional portions of the command line. 

adr is an octal number in the range 0-777777, 
representing user virtual address. 

condition is one or more reason for allowing the break 
to occur. 

Multiple conditions may be specified within one command; these 
conditions are separated from one another by a comma. The 
possible conditions which may be specified are: 

Condition Meaning 

READ Break if the contents of adr are read by the program. 
Note that this condition causes a break to occur on a 
read-modify write as well as on a read. 

WRITE Break if the location specified by adr is written into. 



An operator-privileged command. See Appendix A of the Operator ' s 
Guide . 
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Condition 
EXECUTE 

ALL 
MUUO 



Meaning 

Break if an instruction is fetched 
specified by adr. 



from the location 



Break if the location specified by adr is read from 
(READ), written into (WRITE), or fetched from 
(EXECUTE) . 

Break on monitor references as qualified by READ, 
WRITE, and/or EXECUTE. 



If all three break conditions are to be specified, you can 
include the word ALL in the command line, replacing the command 
argument string: WRITE, READ, EXECUTE. When desiring breaks on 
monitor references for all three break conditions, you can 
include one of the following command argument strings in the 
command line: either MUUO, ALL or MUUO, READ, WRITE, EXECUTE. 

When issuing a SET BREAK command without specifying any break 
conditions, the conditions specified in the previous SET BREAK 
command are still in effect. If there was no previous SET BREAK 
command, ALL is assumed. When issuing a SET BREAK command 
without specifying any address, the conditions included in the 
command line are ORed with existing break conditions and the 
previously specified address is used. If there are no existing 
break conditions, is the default address. 



In summary, break addresses remain in effect until changed; 
break conditions remain is effect until removed. 



and 



If you wish to remove a break condition, the condition to be 
removed may be specified in the following command: 

SET BREAK NO condition 

If all existing break conditions are to be removed, the following 
command line may be issued: 

SET BREAK NONE 

This command will remove all existent break conditions, but will 
not remove a previously specified address. An example setting a 
default break location is: 

SET BREAK 1000 ON READ, WRITE, EXECUTE 

SET BREAK NO READ 

SET BREAK NONE 

SET BREAK EXECUTE; 1000 IS DEFAULT BREAK LOCATION 

When a break occurs, one of the messages: 

%ADDRESS BREAK AT USER PC xxxxxx 

%ADDRESS BREAK AT EXEC xxxxxx UUO AT USER xxxxxx 

will be typed, and the terminal will be left in monitor mode. 
The second message is produced when MUUO was included in the SET 
BREAK command line. If the user types: 

.CONTINUE 

the program will continue execution at the instruction which 
caused the break. 
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Characteristics 

Requires LOGIN. 

Leaves the terminal in monitor mode. 
Kill) and KL10 processors only. 

Examples 

<• BET BREAK AT 1000 OH READy IJRITE ^ 

♦ SET BREAK EXECUTE ^ 

♦ SET BREAK NONE ^V 

.SET BREAK 1.000 MUUOr EXECUTE* WRITE^ 
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Function 

The SET CDR command sets the file name for the next card-reader 
spooling intercept. (Refer to DECsystem-10 Monitor Calls.) This 
command is generally not needed, even when the card reader is 
being simulated on the disk via the spooling mechanism. It is 
included in case you wish to reset or change the spooling. In 
addition, the Batch Controller uses this command to read spooled 
input card decks. 

Command Format 

SET CDR filename 

filename = one- to three-character file name to be used on 
next card-reader INIT. 

Characteristics 

The SET CDR command: 

Leaves the terminal in monitor mode. 
Examples 

» SET CDR (\ ^J 

♦ SET CDR HAS^ 
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Function 

The SET CPU command allows the privileged user to change the CPUs 
on which their job can run. It is used in a multiprocessing 
system to specify whether the programs run under the job can be 
processed on the primary CPU, the secondary CPU, or either CPU. 
The job remains with the specified CPU until 1) another SET CPU 
command with a different specification is given, 2) a KJOB 
command is issued, or 3) you as privileged user's program 
override the SET CPU command by issuing the SETUUO with a 
different specification. If the SETUUO overrides the command, 
the specification given in the UUO remains in effect until a 
RESET or EXIT UUO or another SETUUO with a different 
specification is executed. When an EXIT or RESET UUO is 
executed, the job reverts back to the specification given in the 
last SET CPU command. When you log in, the CPU specification is 
usually set to ALL. The schedulers for each CPU competed for 
jobs with the ALL specification so that the load is dynamically 
balanced between CPUs. Therefore, this command is generally not 
needed but is provided in case the user wishes to change the CPU 
specification. 

Command Formats 

1. SET CPU CPxn 

adds the specified CPU to the jobs CPU specification. 

2. SET CPU NO CPxn 

removes the specified CPU from the job's CPU 
specification. 

3. SET CPU ALL 

adds all of the CPUs to the job's CPU specification. 

4. SET CPU ONLY CPxn 

changes the CPU specification so that it includes only 
the specified CPU. 

x = either U designating a logical name, or A or I 
designating physical names for a KAlO processor 
(DECsystem-1055) or KI10 processor (DECsystem-1077) , 
respectively. 

n = a decimal number from to the number of processors in 
the system. 

Characteristics 

The SET CPU command: 

Leaves the terminal in monitor mode. 

Restrictions 

The privileges required for using this command are determined by 
bit 5 (JP.CCC) of the privilege word, .GTPRV. 
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Examples 

♦ BET CPUO ONLY CPU1 +J 

♦ SET CPU CPAOV 
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Function 

The SET DEFAULT command sets a default protection code for any 
files you may create. Any value you set with this command 
overrides the system's standard protection code. Your system 
administrator sets the system's standard protection code, which 
is usually 057, via MONGEN. 

Command Format 

SET DEFAULT PROTECTION ON 
SET DEFAULT PROTECTION OFF 
SET DEFAULT PROTECTION n 

The arguments to the SET DEFAULT PROTECTION command are 
described below. 

n is the value the system will use as the protection code 
for any files you may create. 

ON indicates to the system that it is to use your specified 
protection code (i.e., n) . 

OFF indicates that the system is to use the system's 
standard protection code when you create files, even if you 
have issued a SET DEFAULT PROTECTION n command. 

Characteristics 

Requires LOGIN. 

Leaves your terminal in monitor mode. 

Example 

♦SET DEFAULT PROTECTION ON 
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Function 

The SET DENSITY command sets a default density (bits/inch) for 
the specified magnetic tape. 

Command Format 

SET DENSITY MTAnrdensity 

MTAn: where n is the number of the magnetic tape drive for 
which the density is to be set, or a logical name associated 
with a physical magnetic tape. You must have the device 
assigned to you. This argument is required. 

density = 200 bits/inch 

556 bits/inch 

800 bits/inch 
1600 bits/inch 
6250 bits/inch 

This argument is required. 

Characteristics 

The SET DENSITY 

Leaves the terminal in monitor mode. 
Examples 

♦ SET DENSITY MTA005: 'o56^J 
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Function 

The SET DSKFUL command controls the treatment of your job when it 
is attempting output and there is either not space available on 
the file structure being referenced or your quota for that 
structure is exceeded. 

Command Formats 

1. SET DSKFUL ERROR 

Outputting stops and an error condition is passed to the 
program. Most programs respond to the error condition by 
issuing an error message and returning the job to monitor 
level without any opportunity for the user to continue. 

2. SET DSKFUL PAUSE 

Output stops and execution of the program is suspended. An 
error message is printed on your terminal and control of the 
job is returned to the monitor. Generally, you should employ 
the SEND command to request assistance from the operator. 
Execution of the program can be resumed with the CONTINUE 
command as long as you do not give a command that destroys 
the core image of the interrupted program. However, the 
program will again be stopped if the problem of insufficient 
disk space or insufficient quota has not been corrected in 
the interim. 

The default setting is ERROR unless your accounting file entry 
specifies PAUSE as your defalt. 

Characteristics 

The SET DSKFUL command: 

Leaves the terminal in monitor mode. 
Examples 

SET DSKFUL JP AUG E~J 
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Function 

The SET DSKPRI command allows the privileged user to set the 
priority for his job's disk operations (data transfers and head 
positionings) . The standard priority is 0, and the range of 
permissible values is -3 to +3. This means that a priority lower 
than the standard can be specified as well as one higher than the 
standard. The priority specified applies to all disk I/O 
channels currently open or subsequently opened whose priority has 
not been explicitly set with a DISK, monitor call. (Refer to 
DECsystem-10 Monitor Calls.) The priority specified in the SET 
DSKPRI command remains in effect until 1) another SET DSKPRI 
command is given with a different priority, 2) a KJOB command is 
issued, or 3) your program overrides the SET DSKPRI command by 
issuing a DISK, monitor call with a different priority. 

Command Format 

SET DSKPRI n 

n = a decimal number from -3 to +3 indicating the priority 
to be associated with the job's disk operations. When n =0, 
the priority is the normal timesharing priority. 

Characteristics 

The SET DSKPRI command: 

Leaves the terminal in monitor mode. 

Restrictions 

The privileges required for using this command are determined by 
bits 1 and 2 of the privilege word, .GTPRV. These two bits 
specify an octal number from 0-3. The user is always allowed a 
priority. 

Examples 

.SET DSKPRI 2~J 
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Function 

The SET HPQ command allows the privileged user to place their job 
in a high-priority scheduler run queue. With this command, you 
obtain a faster response and CPU time than in the normal 
timesharing queues. The job remains in the specified 
high-priority queue until 1) another SET HPQ command to a 
different high-priority queue is given, 2) a KJOB command is 
issued, or 3) your program overrides the SET HPQ command by 
issuing an HPQ UUO with a different value. If an HPQ UUO 
overrides the command, the level specified in the UUO remains in 
effect until a RESET or EXIT UUO or another HPQ UUO with a 
different value is executed. When an EXIT or RESET UUO is 
executed, the job is returned to the high-priority queue 
specified in the SET HPQ command. 

Command Format 

SET HPQ n 

n = a decimal number from to 15 indicating the 
high-priority queue to be entered. When n = 0, the queue is 
the normal timesharing run queue. Queue numbers from 1 to 
15 are high-priority queues. The number of high-priority 
queues is an installation parameter and may be less than 15. 

Characteristics 

The SET HPQ command: 

Leaves the terminal in monitor mode. 

Restrictions 

The privileges required for using this command are determined by 
bits 6 through 9 of the privilege word, .GTPRV. These four bits 
specify an octal number from 0-17, which is the highest priority 
queue you can attain. 

Examples 

♦SET HPQ A^J 
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Function 

The SET PHYSICAL command is used to specify the maximum current 
physical page limit (CPPL) , if the word LIMIT is included within 
the command line. (CPPL is described in Chapter 1 of The Monitor 
Calls Manual.) By including the word GUIDELINE in the command 
line, the SET PHYSICAL command is used to establish a guideline 
for the page fault handler. The page fault handler will then use 
the specified figure as a guideline in determining the exact time 
a program will go virtual. 



Command Format 






SET PHYSICAL 


LIMIT 


nP 




GUIDELNE 


nK 



where: LIMIT and GUIDELINE are alternative portions of the 
command line. If both are omitted, GUIDELINE is 
assumed. 

IK equals 1024 words, and IP equals a page of 512 
words. If K and P are omitted, K is assumed. 

K may be specified within the range 1 to 256K; P may 
be specified within the range 1 to 512P. 

If the command SET PHYSICAL LIMIT is given with a 
argument, the job will never "go virtual." 

Characteristics 

Requires LOGIN. 

Leaves the terminal in monitor mode. 
Example 

♦ SET PHYSICAL 100P^ 



♦ SET PHYSICAL GUIDELINE 2K^ 

♦ SET PHYSICAL LIMIT 50K^ 



2-212 



SET SPOOL Command 



Function 

The SET SPOOL command adds devices to or deletes devices from the 
current list of devices being spooled for this job. Spooling is 
the mechanism by which I/O to or from slow-speed devices is 
simulated on disk. Devices capable of being spooled are: the 
line printer, the card punch, the card reader, the paper tape 
punch, and the plotter. 

Command Formats 

1. SET SPOOL devl,dev2,. . .devn 

adds the specified devices to the job's spool list. 

2. SET SPOOL ALL 

places all spooling devices into the spool list. 

3. SET SPOOL NONE 

clears the entire spool list. 

4. SET SPOOL NO devl ,dev2 , . . .devn 

removes the specified devices from the job's spool list. 

devl,dev2, . . .devn = physical device names of one or more 
devices to be added to or deleted from the current spool 
list. These names are taken from the following list: CDP, 
CDR, LPT, PLT, PTP. 

Characteristics 

The SET SPOOL command: 

Leaves the terminal in monitor mode. 

Restrictions 

To unspool devices, the job must have 1) the privilege bit set in 
.GTPRV, 2) bit 28 (200 octal) set in the STATES word by the 
operator SET SCHED command, or 3) you must be logged-in under 
[1,2]. 

Examples 

.SET spool cdp: 

♦ SET SPOOL NO LPT J 
♦SET SPOOL NONE 
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Function 

The SETSRC program is used to manipulate the job's search list or 
the system's search list. A search list is defined to be the 
order of the file structures that are to be searched whenever 
generic device DSK: is explicitly or implicitly specified by 
you. This search list is originally defined by the system 
manager to include the file structures that you can access. With 
the SETSRC program, you can alter the search list defined for you 
by adding or deleting file structures. 

The search list is of the form 

fsl/s/s, fs2/s/s, ..., FENCE, . ..,fs9/s/s 

where fs is the name of the file structure and /s is a switch 
modifying the file structure. The file structures on the left of 
the FENCE comprise the active search list and represent the 
generic device DSK for this job. The files to the right of the 
FENCE comprise the passive search list and represent file 
structures that were once in the active search list. File 
structures are kept in the passive search list in order that 
quotas can be checked on a DISMOUNT or KJOB command. The FENCE 
represents the boundary between the active and passive search 
list. 

Note that the MOUNT and DISMOUNT commands can also change the 
job's search list by adding or deleting a file structure. 
Because the SETSRC program does not create a UFD if one does not 
exist, the MOUNT command should be used to create a UFD. The 
name of the new file structure is placed at the end of the search 
list. (Refer to the SETSRC specification in the DECsystem-10 
Software Notebooks for a complete description of the SETSRC 
program. ) 

Command Format 

R SETSRC 

You can then respond with any of the following commands: 

Command Explanation 

A Add one or more file structures to the 

existing list. The file structures 
(with any switches) are appended to the 
beginning or the end or the active 
search list according to the following 
specifications: 

1. If no asterisk appears in the 
specifications (e.g., fsl, fs2) or 
if an asterisk appears before the 
file structure names (e.g., *,fsl, 
fs2) , the file structures are added 
to the end of the search list. 
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Command Explanation 

2. If the asterisk follows the file 
structure names (e.g., fsl, fs2, *,), 
the file structures are added to the 
beginning of the search list. 

3. If the asterisk appears in the middle of 
the file structures (e.g., fsl, *, fs2) , 
the file structures before the asterisk 
are added to the beginning of the search 
list and the file structures after the 
asterisk are added to the end. 

If the specified file structure is 
currently in the search list, it is 
removed and then added in the desired 
position. Therefore, this command can 
be used to reorder the search list. 

C Create a new search list for this job. 

Any file structures in the current 
search list that are not in the new list 
are moved to the passive search list. 

CP Create a new default directory path. 

CS Create a new system search list (i.e., 

the file structure search list for 
device SYS:). You must be logged in 
under [1,2] to use this command. 

H Obtain information about the available 

commands. 

M Modify the current search list and DSK 

specification by altering the switch 
settings for individual file structures. 
This command does not add or remove file 
structures from the search list. 

R Remove file structures from the search 

list. They are placed on the right side 
of the FENCE (passive search list) so 
that on subsequent LOGOUTS or DISMOUNTS 
quota limits can be checked. Ersatz 
devices are not affected by this 
command. 

T Type the search list of the job. 

TP Type the default directory path. 

TS Type the system search list. 

The following switches can be used in the SETSRC command 
string. Switches that modify file structures must appear 
immediately after the file structure that they modify. 
Other switches can appear anywhere in the command string. 
The switches can be abbreviated as long as the abbreviation 
is unique. 
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Switches That Modify File Structures 



/CREATE 



/NOCREATE 



/NOWRITE 



/WRITE 



Allow new files to be created on the 
file structure. 

Do not allow new files to be created on 

the file structure when DSK is 

specified, but allow files to be 

superseded. Files can be created on the 

file structure if the user specifies the 
file structure name explicitly. 

Do not allow writing on the file 
structure for this job (i.e., the file 
structure is read only) . 

Allow writing on the file structure. 



If no switches are specified, /CREATE and /WRITE are 
assumed. For compatibility with previous versions of 
SETSRC, /N is equivalent to /NOCREATE and /R equivalent to 
/NOWRITE. 

Switches That Modify The Directory Path 
(used only with the CP command) : 

These switches can be typed in directly as commands by 
omitting the CP command and the slash (i.e., /SCAN is 
equivalent to CP/SCAN) . 



/NOSCAN 
/SCAN 



Cancel the scan switch for the directory 
path. 

Set the scan switch for the directory 
path. 



Switches That Modify The DSK Or SYS Specification 
(used only with the C and M Commands) : 

These switches can be typed in directly as commands by 
omitting the C or M command and the slash (i.e., NOSYS is 
equivalent to M/NOSYS) . 



/LIB: [proj,prog] 



/NOLIB 
/NOSYS 
/NONEW 
/SYS 



Set the job's library directory to the 
UFD [pro j, prog] and add it to your DSK 
specification. This means that if a 
file is not found in your directories in 
your search list, the library directory 
will then be searched for the file. 

Remove the library directory from the 
user's DSK specification. 

Remove the SYS specification from the 
user's DSK specification. 

Remove the [1,5] directory from the 
user's SYS specification. 

Add the SYS specification to the user's 
DSK specification. This means that if a 
file cannot be found in the user's 
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/NEW 



directories in his search list or in his 
library directory (if /LIB: [proj,prog] 
has been specified) , the system 
directory [1,4] will then be searched 
for the file. 

Add the directory [1,5] to the user's 

SYS specification. This means that when 

the system directory is searched, the 

directory [1,5] will be searched before 
the directory [1,4], 



Characteristics 

The R SETSRC command: 



Places the terminal in user mode. 

Runs the SETSRC program, destroying your core image. 

Restrictions 

The user must be logged in under [1,2] to create a new system 
search list. The directory path commands (CP and TP) are 
meaningful only with the 5.04 monitor and later monitors and only 
if FTSFD is on. 



Examples 

♦ R SETSRC ^ 



Your search list 
DSKB. 



is defined as 



DSKB :» FENCE 



#A DSKAU^ 



%1_ 

DSKB J, DSKA* FENCE 



* A DSKCt i%* J 

DSKC X t DSKB X v DSKA X » FENCE 
* R DSKAt ^V 



Add DSKA to the end of the search 
list. 

Your search list is defined as 
DSKB, DSKA. 



Add DSKC to the beginning of the 
search list. 

Remove DSKA from the search list. 



Your search list is defined as 
DSKC, DSKB. 



♦ DSKC: rDSKBJ »/N0WRITE 
* M /LIB? C27>51103 ^ 

*SYS^ 



Do not allow writing on DSKB. 

Set your library directory to 
[27,500] and add it to your DSK 
specification. 



Add SYS: to the user's 
specification. 

/LIB X C27» 51103/SYS DSKC X t DSKB X /NOWRITE* FENCE t DSKA \*J 



DSK 
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Your DSK and SYS specifications are 
listed first followed by the user's 
search list. 



*TS^ 



»SKAt»DSKB:fDSKCJ»FENCE The system search list is defined 

as DSKA,DSKB,DSKC. 
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Function 

The SET TIME command sets a central processor time limit for a 
job. When the time limit is reached, the job is stopped and a 
message is typed. A timesharing job may be continued by typing 
CONT, but no time limit is in effect unless it is reset. A batch 
job cannot be continued. 

Command Format 

SET TIME n 

n = number of seconds of central processor time to which the 
job is limited. An argument of cancels the time 
remaining. 

Characteristics 

The SET TIME command: 

Leaves the terminal in monitor mode. 

Restrictions 

The SET TIME command is ignored in a batch control file. A batch 
job has its time limit set via the /TIME switch in the QUEUE or 
SUBMIT command string or on the $JOB card. 

Examples 

♦ HAKE LOOP ^"4 ^ Create a program with an infinite 

loop. 

& .T.10 CONTINUE ^ 
GOTO tO ^J 

<ESCXESC> 
* ESSX<E5CXESC> " 

. TYPE LQ0P,r4 ^ Type the program. 

.1.0 CONTINUE 

GOTO 10 

END 

. LOAD LOOP ^J Compile and load the program. 

FORTRAN? LOOP 

MAIN* 

LINK* LOADING 

EXIT 

. SET TIME 5 ^7 Set the time limit to 5 seconds. 

. TIM E^y Clear the incremental run time, so 

11*08 that the SET TIME command can be 

.1.1 .08 checked. 
KIL0"-C0RE~SEC~95 

♦ STARTS Start the loop. 

? 

?TIME LIMIT EXCEEDED As expected, the time limit was 

exceeded. 
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♦ TIME ^ 

5 * 00 

16*08 

KIL0--C0RE--SEC«134 
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Function 

The SET TTY command (or TTY command) declares properties of the 
terminal on which the command is typed to the scanner service. 
With terminals connected directly to the DECsystem-10, the system 
manager can set some default conditions, so that this command is 
usually not needed. However, you are likely to need this command 
when connected by telephone lines to a dial-up data set, because 
it may not be possible for the system manager to predict the type 
of terminal which will be used. 

Note that all SET TTY commands can be followed by a TTYn: 
specification, but these become operator-privileged commands. 
(See Appendix A of the Operator's Guide .) 

Command Formats 

1. SET TTY NO word 

equivalent to TTY NO word 

2. SET TTY word 

equivalent to TTY word 

3. SET TTY TTY:n NO word 

equivalent to TTY TTY:n NO word 

4. SET TTY TTY:n word 

equivalent to TTY TTY:n word 

NO = the argument that determines whether a bit is to be set 
or cleared. This argument is optional. 

word = the various words representing bits that may be 
modified by this command. The words are as follows: 



SET TTY ALTMODE 



SET TTY NO ALTMODE 



SET TTY BLANKS 



SET TTY NO BLANKS 



Converts the ALTmode codes of 175 
and 176 to the ASCII standard 
escape character 033 (initial 
state) . 

Restores the individual identity of 
the codes 175 and 176. 

Restores multiple carriage 
return/line feeds and form feeds 
(initial state) . 

Suppresses blank lines (consecutive 
carriage return/line feeds after 
the first) and outputs form feeds 
and vertical tabs as 2 carriage 
return/line feeds. This is useful 
for a video display terminal in 
order to increase the amount of 
output which fits on the screen. 



SET TTY COPY Outputs 
controlling terminal. (VT50). 



to 
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SET TTY NO COPY 



SET TTY CRLF 



SET TTY NO CRLF 



SET TTY DEBREAK 



SET TTY NO DEBREAK 



Outputs ESC to controlling terminal 
(VT50) . 



Restores the automatic 
return (initial state) . 



carriage 



The carriage return normally output 
at the end of a line exceeding the 
carriage width is suppressed. 

Notifies the system that the 
terminal has a feature that allows 
the computer to lock the keyboard 
(Model 2741 terminals). 



Turns off 
command. 



the SET TTY 



DEBREAK 



SET TTY ECHO 



SET TTY NO ECHO 



SET TTY ELEMENT 



Restores the normal echoing of each 
character typed in. Most terminals 
on the DECsystem-10 are used in 
full-duplex mode which means that 
the terminal does not print each 
character as you type it. Instead 
the monitor must echo each 
character typed so that the 
character will be printed. If a 
terminal prints "C when it is typed 
but does not print any of the 
non-control characters you type, 
then this command can be used to 
establish normal echoing. (Initial 
setting determined by each 
installation when constructing its 
monitor at MONGEN time.) 



This command suppre 
echoing of input char 
copy terminals (i.e 
that automatically 
character as the user 
not require normal mo 
because the echoing 
each character typed 
twice. This command 
stop double print 
character typed on 
terminal. (Initi 
determined by each 
when constructing i 
MONGEN time. ) 



sses monitor 
acters. Local 
. , terminals 

print each 

types it) do 

nitor echoing, 

would cause 
to be printed 

is used to 
ing of each 
a local copy 
al setting 

installation 
ts monitor at 



Changes the typing element number 
for Model 2741-type terminals. The 
element numbers available are: 



Element 


Meaning 


987 


APL correspondence 


029 


Standard correspondence 


087 


Call 360 BASIC 


963 


Extended binary 


938 


BCD 


988 


APL (EBCD) 



2-222 



SET TTY or TTY Command (Cont.) 



Note that the SET TTY ELEMENT n 
command also sets the terminal as 
if the SET TTY NO LC command were 
used. 



SET TTY NO ELEMENT 



Turns off the SET TTY 
command. 



ELEMENT n 



SET TTY FILL n 



The filler class n is assigned to 
this terminal. Many different 
types of terminals are supported by 
the DECsystem-10 operating system. 
Some terminals require one or more 
filler characters to be sent 
following certain control 
characters such as line feed (LF) 
and horizontal tab (HT) . The table 
below illustrates the number of 
fillers sent for each character and 
filler class. The filler 
characters are CR (215 octal for 
even parity) for carriage return 
characters (CR, 215 octal) and DEL 
(RUBOUT, 377 octal) for all other 
characters. No fillers are 
supplied for image mode output 
(initial setting determined by each 
installation when constructing its 
monitor at MONGEN time) . 



SET TTY NO FILL 



Charact 


er 


Octal 




Name 









BS 




010 





HT 




Oil 





LF 




012 





VT 




013 





FF 




014 





CR on outp 


ut 


015 





free CR 3 









CRLF on ou 


tput 


015-012 





XON 




021 


1 


TAPE 




022 


1 


XOFF 




023 


1 


NTAP 




024 


1 



Equivalent to TTY FILL (initial 
setting determined by each 
installation when constructing its 
monitor at MONGEN TIME). Fillers 
for output and echoing are 
determined from the following: 

Number of Fillers for Filler Class 
12 3 



2 
or 
2 
2 
12 
1 
2 
3 
1 
1 
1 
1 



6 

6 
6 
21 
3 
4 
9 
1 
1 
1 
1 



6 
or 2 
6 
6 

2 \> 

4 

9* 

1 

1 

1 

1 



1 if 0-3 spaces to tab stop; 2 if 4-7 spaces to tab stop. 

Output only; no fillers on input. 

Refer to the SET TTY CRLF command. 

Sum of the fillers output for a CR and LF. 
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SET TTY FORM 



This terminal has hardware FORM 
(PAGE) and VT (vertical tab) 
characters (initial setting 
determined by each installation 
when constructing its monitor at 
MONGEN time) . 



SET TTY NO FORM 



The monitor sends eight line feeds 
for a FORM and four line feeds for 
a VT (initial setting determined by 
each installation when constructing 
its monitor at MONGEN time). 



SET TTY GAG 



SET TTY NO GAG 



Messages transmitted by the SEND 
command cannot be received at this 
terminal unless the terminal is at 
command level (initial state) . 

Messages transmitted by the SEND 
command can be received at this 
terminal even though it is not at 
command level. 



SET TTY HOLD 



SET TTY NO HOLD 



SET TTY TTYn: IGNORE 



SET TTY TTYn: NO IGNORE 



SET TTY LC 



SET TTY NO LC 



SET TTY PAGEn 



Outputs ESC [ to controlling 
terminal. (VT50) . 

Output ESC\ to controlling 
terminal. (VT50) . 

Operator-privileged command. (See 
Appendix A of the Operator ' s 
Guide . ) 

Operator-privileged command. (See 
Appendix A of the Operator ' s 
Guide . ) 

The translation of lowercase 
character input to uppercase is 
suppressed. 

This command causes the monitor to 
translate lowercase characters to 
upper case as they are received. 
Some terminals have only uppercase 
characters, while others have both 
uppercase and lowercase. 
Frequently, it is convenient to 
have a terminal with both uppercase 
and lowercase simulate the behavior 
of one with uppercase only. This 
command causes the monitor to 
perform this simulation. The echo 
sent back by the monitor always 
matches the case of the characters 
after translation. By looking at 
the printout, you can determine 
what translation was performed by 
the monitor (initial state) . 

This command gives the user the 
ability to temporarily suspend 
system output to a terminal without 
losing it. The XOFF key (~S) 
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suspends the typeout, and the XON 
key (~Q) restores it for n lines. 
The XOFF and XON keys are not 
echoed and are not sent to the 
user's program. This command is 
useful for video display terminals 
where the user may want to read a 
page of text before it disappears 
from the screen. Note that this 
preempts the use of ~S and "Q for 
reading paper tapes. (See SET TTY 
TAPE . ) 



SET TTY NO PAGE 



The terminal output control ability 
of the XOFF and XON keys is 
disabled. The current 
interpretation of these keys 
depends on the last SET TTY TAPE 
command (initial state) . 



SET TTY INCOMPATIBILITY 



Disables the "R and ~T features. 
(See Section 1.3.1 for a 
description of "R and "T.) 



SET TTY NO RTCOMPATIBILITY 



Turns on the "R and "T features. 
(See Section 1.3.1 for a 
description of "R and ~T.) 



SET TTY SLAVE 



The terminal becomes si 
no commands may be 
terminal, and the termi 
ASSIGNed by another us 
slave your own termin 
must contact the opera 
to unslave it (initial 
determined by each 
when constructing its 
MONGEN time) . 



aved, i.e. , 
typed on the 
nal may be 
er. You can 
al and you 
tor in order 

setting is 
installation 

monitor at 



SET TTY TTYn:NO SLAVE 



Operator-privileged command. (See 
Appendix A of the Operator ' s 
Guide. ) 



SET TTY SPEEDn 



Set to n baud the speed at which 
the system sends and receives. 
(You adjust the speed at the 
terminal by setting a switch on the 
terminal. ) 



SET TTY SPEEDm,n 



Set the terminal transmitting speed 
to n and the receiving speed to m. 
(This is especially useful for 
display terminals that permit 
transmitting and receiving at 
different speeds.) 



SET TTY TAB 



This terminal has hardware TAB 
stops every eight columns (initial 
setting is determined by each 
installation when constructing its 
monitor at MONGEN time) . 
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SET TTY NO TAB The monitor simulates TAB output 

from programs by sending the 

necessary number of SPACE 
characters. 

SET TTY TAPE The XON key (~Q) causes the 

terminal to read paper tape. The 
XOFF key ("S) causes the terminal 
to stop reading paper tape. (Refer 
to Chapter 5 of Decsystem-10 
Monitor Calls . ) 

SET TTY NO TAPE The XON key ("Q) and the XOFF key 

("S) have no special paper tape 
function. They may have a PAGE 
function (initial state) . 

SET TTY TIDY Specifies (for Model 2741 

terminals) that every character 

occupy one print space. The 

terminal normally types out 

characters so that they appear the 

same as you type them in. For 

example, [prints out as "<. In 
TIDY mode, [prints out as <. 

SET TTY NO TIDY Turns off the SET TTY TIDY command. 

SET TTY UC Equivalent to SET TTY NO LC . 

SET TTY NO UC Equivalent to SET TTY LC. 

SET TTY WIDTH n The carriage width (the point at 

which a free carraiage return is 
inserted) is set to n. The range 
of n is 17 (two TAB stops) to 200 
decimal. The initial state is 72. 

Characteristics 

The SET TTY command: 

Leaves the terminal in monitor mode. 
Does not require LOGIN. 

Restrictions 

The SET TTY (or TTY) command is not available to the batch user. 
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Function 

The SET VIRTUAL LIMIT command is used to specify the current 
virtual page limit (CVPL) . CVPL is described in Chapter 1 of the 
Monitor Calls Manual . 

Command Format 

SET VIRTUAL LIMIT nK 

nP 

where: LIMIT is an optional portion of the command line. 

IK equals 1024 words, and IP equals a page of 512 
words. If K and P are omitted, K is assumed. 

K may be specified within the range 1 to 256K; P may 
be specified within the range 1 to 512P. 

If the command SET VIRTUAL LIMIT is given with a argument, the 
value specified for CVPL is used. CVPL is set by the system 
administrator and indicates the current virtual page limit. 

Characteristics 

Requires LOGIN. 

Leaves the terminal in monitor mode. 
KI10/KL10 processors with virtual memory only. 

Example 

♦ SET VIRTUAL LIMIT 32K ^ 

. SET MATCH ^y 

? ARGS ARE t DAY t RUN » WA I T » READ * WRI TE t VERS I ON » MTA r ALL t NONE 

. SET MATCH DAY ^ 

. SET MATCH RUH ^J 

. SET MATCH UAIT ^y 

. SET MATCH VERSION DAY ^ 

. RUN LOOP ^y 
<:l.4J26M0> 
TLOOP.SAV NOT FOUND 
<0.06 0.9:1. > 

. R PlP ^y 
<14J2A*50> 

<StPIP 33BC260) +> 

<0.0B 6.08 > 
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Function 

The SET WATCH command sets the system to print incremental job 
statistics automatically. This command provides the user with a 
tool for measuring the performance of his programs. 

Command Formats 

1. SET WATCH arg(l) ,arg(2) ,.. . ,arg(n) 

prints the specified WATCH statistics. 

2. SET WATCH ALL 

prints all the WATCH statistics. 

3. SET WATCH NONE 

eliminates the printing of all WATCH statistics. 

4. SET WATCH NOagr (1 ) , arg ( 2) , . . . , arg (n) 

eliminates the printing of the specified WATCH 
statistics. 

The following arguments enable printing whenever a monitor 
comand switches the console from monitor the user mode. 

arg = DAY prints the time of day, as [HHtMM.SS] 

arg = VERSION prints the version of the program in 
standard format (refer to the VERSION command). 

The following arguments enable printing whenever the console 
is returned to monitor mode via the "C, EXIT, HALT, ERROR IN 
JOBn, or DEVICE xxx OPR zz ACTION REQUESTED messages. 

arg = READ prints the incremental number of disk blocks 
read modulo 4096. 

arg = RUN prints the incremental run time. 

arg = WAIT prints the wait time (time elapsed since the 
user started or continued the program) . 

arg = WRITE prints the incremental number of disk 
blocks written modulo 4096. 

When an UNLOAD is performed, MTA prints magtape statistics in the 
following form. 

[MTxnrreelid READ (c/h/s) = a/b/c WRITE (c/h/s) = d/e/f] 

where: x is an alphabetic representing the tape controller. 

n is a number representing the drive number. 

reelid is the reel identification. 

a is the number of characters read. 
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b is the number of hard-read errors. 

c is the number of soft-read errors. 

d is the number of characters written. 

e is the number of hard-write errors. 

f is the number of soft-write errors. 

When a, b, and c are 0, the information pertaining to READ will 
not be printed. 

When d, e, and f are 0, the information pertaining to WRITE will 
not be printed. 

To prevent this message from being printed, the user can type the 
following command: 

.SET WATCH NO MTA 

This message will be produced by an UNLOAD (MTAPE11) . 

Any combination of the arguments may be specified in any order. 
Statistics are not printed for commands that do not run programs, 
such as ASSIGN or PJOB. When you log in your job is set to WATCH 
the statistics of which you notified the system manager. The 
information on what statistics to WATCH is kept in ACCT.SYS. 

The order of the error messages is the same as the order of 
output. Therefore, if you forget either the argument or the 
significance of the statistics you can find these out by typing 
SET WATCH and examining the message. A single space is always 
typed between each statistic, whether the statistic appears or 
not; therefore, it is possible to tell which statistics are 
being typed. 

NOTE 

Enabling WATCH output interacts with the incremental data 
typed by the TIME and DSK commands. 

Characteristics 

The SET WATCH command: 

Leaves the terminal in monitor mode. 

Examples 

♦ SET WATCH ^J 

? A v ti s a r e ♦ d a w v r u n y w a i t y r e a d y w r i t e y v e r s i o n y iri t a j> a 1 1 y n o n e 

. SET MATCH DAY ^ 

» SET MATCH RUN ^ 

. SET MATCH UAIT ^ 

. SET MATCH VERSION DAY ^ 

» R SOS ^ 
C8J33M63 
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ess sos 21 <:i. 34) + ::i 

File: 2£ 
i::o.:i.8 10*16 :j 

i::as34:o4::i 

CSS PI P 33CC344) + II 

co* o:i. 6,65 ::i 
i::e:34S:i.6:i 

CSSTECO 24(202) •}• 3 
CO. 03 8.15 3 
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Function 

The SKIP command moves a magnetic tape forward a specified number 
of files or records or to the logical end of tape. This command, 
depending on its arguments, is equivalent to the following PIP 
command strings: 

MTAn: (M #nA) = 
MTAn: (M #nD) = 
MTAn: (M #nT) = 

SAVed files on magnetic tape always contain two files, a high 
segment file and a low segment file. If one of the segments is 
missing, a null file containing one record is written for the 
missing agent. Thus, in order to space over a SAVed file, the 
user must skip two files. Refer to Appendix D of the format of a 
SAVed file. 

Command Formats 

1. SKIP MTAn: x FILES 

advanced forward x files. 

2. SKIP MTAn: x RECORDS 

advances forward x records. 

3. SKIP MTAn: EOT 

advances forward to the logical end of tape. 

The words FILES, RECORDS, and EOT can be abbreviated to F, R, and 
E, respectively. 

Characteristics 

The SKIP command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, thereby destroying your core image. 

Examples 

* S K IP MTAQOi: EOT +J 



♦ SKIP MTAQ02? 20 RECORDS^ 



1 This command runs the COMPIL program, which interprets the command 
before running the PIP program. 

2-231 



START Command 



Function 

The START command begins execution of a program that you either 
loaded previously with the GET command or that you interrupted 
while running (e.g., "C). The old program counter is copied from 
.JBPC to .JBOPC. You can optionally specify an explicit start 
address, if omitted, the address supplied in the file (.JBSA) is 
used. If you specify an address argument and the job was 
executing a monitor call when interrupted (i.e., it was in exec 
mode but not in TTY input wait or SLEEP mode) , the monitor sets a 
status bit (UTRP) and continues the job at the location at which 
it was interrupted before trapping to the specified START 
address. When the monitor call processing is completed, the 
monitor clears the status bit, sets .JBOPC to the address 
following the monitor call, and then traps to the START address. 
If the job is in TTY input wait or SLEEP mode, the trap to the 
program occurs immediately, and .JBOPC contains the address of 
the monitor call. If the job is in user mode, the trap also 
occurs immediately. 

Command Format 

START addr 

addr is the address at which execution is to begin if other 
than the location specified within the file (.JBSA). This 
argument is optional. If you do not specify this argument, 
the address comes from .JBSA. You may specify a starting 
address of 0. 

Characteristics 

The START command: 

Places your terminal in user mode. 

Will not operate while a device transmits data. 

Requires core. 

Requires LOGIN if you specify an address argument. 

Example 

♦ START *J 
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Function 

The SUBMIT command places entries into the input queue for the 
batch system. This command is equivalent to the following form 
of the QUEUE command: 

QUEUE INP: jobname = control file, log file 

Command Format 

SUBMIT jobname = control file, log file 

jobname is the name of the job being entered into the queue. 

control file is the name of the control file. This file 
contains all monitor-level and user-level commands for 
processing by the Batch Controller (BATCON) . 

log file is the name of the log file. This file is used by 
the Batch Controller to record its processing of the job. 

Only the two files mentioned above can be specified in a request 
to the batch input queue. The name of the control file is 
required; the log file name is optional and, if omitted, is 
taken from the control file. If the job name is omitted, it 
defaults to the name of the log file, if present, or the name of 
the control file. If an extension is omitted, the following are 
assumed: 

.CTL for the control file 
.LOG for the log file 

You can obtain a listing of entries in the input queue for 
specific project-programmer numbers by following the command with 
the desired project-programmer numbers enclosed in square 
brackets (e.g., SUBMIT [27,4072]). If no arguments appear in the 
command string (i.e., only the command name is given), all 
entries in the batch input queue for all jobs are listed. 

Three categories of switches can be used in the command string: 

1. Queue-operation - Only one of these switches can be placed in 
the command string because this category defines the type of 
queue request. The switch used can appear anywhere in the 
command string. 

2. General - Each switch in this category can appear only once 
in the command string because these switches affect the 
entire request. The switch used can appear anywhere in the 
command string. 

3. File control - Any number of these switches can appear in the 
command string because these switches are specific to 
individual files within the request. The switch used must be 
adjacent to the file to which it applies. If the switch 
precedes the filename, it becomes the default for subsequent 
files. For example, the command string 

SUBMIT FILEA/DISP:PRE,FILEB 

indicates that the DISPOSE switch applies only to FILEA. The 
command string 
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SUBMIT /DISP:PRE FILEA,FILEB 

indicates that the switch applies to both files. 

See the QUEUE command for a complete list of switches and their 
functions. 

Characteristics 

The SUBMIT command: 

Leaves the terminal in monitor mode. 

Runs the QUEUE program. 

Does not require LOGIN when only queue listings are desired. 

Examples 

. SUBMIT USR JQB-CQNTRL « LQGFIL ^V 

The defaults are as follows: 

1. control file name is CONTRL.CTL 

2. log file name is LOGFIL.LOG 

3. no cards punched (/CARDS: 0) 

4. maximum core of 25K (/CORE: 25) 

5. no dependency (/DEPEND: 0) 

6. control and log files are saved after spooling 
(/DISPOSE : PRESERVE ) 

7. no paper tape punched (/FEET:0) 

8. all line printer output is spooled with the maximum pages 
being 200 (/OUTPUT: 4, /PAGE: 200) 

9. priority is 10 (/PRIORITY: 10) 

10. standard protection is assumed (/PROTECT:nnn (standard)) 

11. job is not restarted after a crash (/RESTART: 0) 

12. maximum CPU time is 5 minutes (/TIME: 0:05) 

13. no plotter time allowed (/PLOT:0) 

14. only one job at a time under a given project-programmer 
number is run (UNIQUE: 1) 

, SUBMIT USRJQB«/MQDIFY/FEET i 3'5/CQRE ^ 

Modify the original request to include 35 feet as the maximum 
number of feet of paper tape that the job can punch and 40K of 
core as the maximum amount of core that the job can use. This 
command is valid only if the job has not been started yet by the 
batch system. 

» SUBMIT USRJOB«/KIL.L V 

Kill the job only if it has not been started by the batch system. 
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Function 

The SYSTAT command runs a system program that prints status 

information about the system. This information allows you to 

determine the load on the system before logging-in. 

To write the output on the disk as a file with name SYSTAT.TXT, 
assign device DSK with logical name SYSTAT. 

The SYSTAT command types the status of the system: system name, 
time of day, date, uptime, percent null time (idle plus lost 
time), number of jobs in use. 

It types the status of each job logged-in: job number; 
project-programmer number (**,** = detached, [OPR] = the 
project-programmer number of the operator, [SELF] = user's 
project-programmer number) : terminal line number (CTY = console 
terminal, DET = detached, Pn = PTY number); program name being 
run; program size; job and swapped state (refer to DECsystem-10 
Monitor Calls) ; run time since logged-in. 

It types the status of high segments being used: name (PRIV = 
nonsharable, OBS = superseded) ; device or file structure name 
from which the segment came; directory name (**,** if detached); 
size (SW = swapped out, SWF = swapped out and fragmented, F = in 
core and fragmented on disk, SPY = user is executing the SPY 
monitor call) ; number of user in core or on the disk. 

Included in the command's response is the amount of swapping 
space used, the virtual core used, swapping ratio, active 
swapping ratio, virtual core saved by sharing, average job size. 

It types status of busy devices: device name, job number, how 
device is assigned (AS = ASSIGN command, INIT = INIT or OPEN 
monitor call, AS+INIT = both ways). 

It types system file structures: free blocks, mount count, 
single-access job. 

It types remote stations: number of station, status of station. 

It types dataset control: number of the TTY, status of TTY. 

Command Format 

SYSTAT arg 

arg is one or more single letters (in any order) used to 
type any subset of the SYSTAT output. This argument is 
optional and if you omit it, the entire SYSTAT output is 
listed. The following lists the various arguments to the 
SYSTAT command. 

B busy device status 

C continuous SYSTAT 

D dormant segment status 

E non-disk error report 

F file structure status 

G other system status 

H help text listing the arguments 

J job status 

L list the SYSTAT output on LPT 

2-235 



SYSTAT Command (Cont.) 



N non-job status (i.e., all information except J) 

P disk performance 

R remote station status 

S short job status 

T dataset status 

V if using a display (for paged output) 

X read the file DSK:CRASH.EXE if found, otherwise read 
specified crashed monitor written in EXE format. 

Meanings of job state codes: 

RN in a run queue 

WS I/O wait satisfied 

TS TTY I/O wait satisfied 

DS Disk I/O wait satisfied 

AU Disk alter UFD wait 

PS Paging I/O wait satisfied 

MQ disk monitor buffer wait 

DA disk storage allocation (sat block) wait 

CB disk core block scan wait 

Dl DECtape control wait 

D2 2nd DECtape control wait 

DC data control wait 

CA core allocation wait (to be locked) 

EV exec virtual memory wait 

10 I/O wait 

TI TTY I/O wait (input) 

DI disk I/O wait 

SL sleep wait 

NU null state 

ST stop ("O state 

JD daemon wait 

"D daemon wait 

TO TTY output 

"C job stopped 

"W command wait 

OW operator wait 

HB hibernate state 

PI paging I/O wait 

EW event wait 

NA nap (short sleep) 

You can obtain output for individual jobs by specifying one of 
the following after the command: 

A number n that causes information to be listed only for the 
indicated job (i.e., job n) . A period causes information 
for your job to be output. 

A project-programmer number specified in square brackets 
causes information to be output only for jobs with the 
specified project-programmer number. The project and/or 
programmer number can be wild (i.e., specified with an 
asterisk) . 

A number preceded by a number sign (#n) causes information 
to be output only for jobs from the indicated terminal 
(i.e., TTYn) . In addition, a C following the command 
indicates CTY, Pnn indicates PTYnn, Tnn indicates TTYnn, and 
a period indicates the terminal on which the SYSTAT command 
is issued. 
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Characteristics 

The SYSTAT command: 

Leaves your terminal in monitor mode. 

Runs the SYSTAT program, destroying your core image. 

Does not require LOGIN. 

Examples 

♦ SYSTAT V 

Status of SCLIZA KL10 SYS#.1.026 at 11J25I52 on 04-Au<-J--77 

Uptime Ii48?39+li43!47* 10+AiZNull time « 10+38%Idle + 0+23%Lost 

66 Jobs in use out of 160* 64 Io«$s$ed in» 3 detached out of 160* (LOOM A 

X) 



Job 


Who 


Line* 


What 


Size(P) 


State 


Run Time 


1 


C0PR3 


P0J5 


LPTSPL 


26+12 


SL 




48 


':> 


C0PR3 


1 


SYSTAT 


13+ SPY 


~C 




53 


3 


37 * 4620 


46 


SOS 


11 + 16 


TI 




11 


4 


37 * 51 16 


50 


SOS 


11 + 16 


TI 




32 


5 


C0PR3 


4 


OPSER 


2+5 


HB 




5 


6 


C0PR3 


DET 


DAEMON 


24 ISP Y 


SL 




9 


7 


10x2100 


11 


PPN 


1 


"C 




18 


8 


30*4676 


125 


TECO 


5+8 


TI 




2J51 


9 


C0PR3 


CTY 


OPSER 


2+5 


HB 


SW 


1 


10 


C0PR3 


107 


SYSTAT 


19+SPY 


" V C 


SW 


41 


11 


C0PR3 


P2J5 


LPTSPL 


26 + 12 


SL 




56 


12 


31*4775 


27 


TECO 


S+8 


TI 




8 


13 


50? 3615 


34 


TECO 


5+8 


"C 




57 


14 


CQPR3 


P3J5 


0PR0M0 


6+13 


SL 




5 


15 


C0PR3 


DET 


PILDAE 


12 


HB 




6 


16 


C0PR3 


P5J5 


BATCON 


21 + 12 


HB 




10 


17 


C0PR3 


P10J9 


DTELDR 


7 


HB 







18 


C0PR3 


DET 


MIC 


4+14 


SL 




6 


19 


30*4661 


P12J46 


SETSRC 


3 


T 


SW 





20 


COPR'J 





BACKUP 


26 


EW 




1*36 


21 


C0PR3 


P1J9 


SYS INF 


10 


HB 




1 


22 


C0PR3 


P4J9 


QUASAR 


28+12 


HB 




7 


23 


C0PR3 


P6J9 


JUST IF 


29+30 


SL 




3 


24 


37*4537 


51 


DIRECT 


6+21 


" S C 




3 


25 


C0PR3 


P7J9 


ALCOMP 


12+15 


SL 




2 


26 


37*2770 


52 


QUEUE 


14+18 


" 4 C 




13 


27 


12*13 


264 


TECO 


5+8 


T 




57 


28 


37*4562 


227 


SOS 


11 + 16 


DA 




2J54 


29 


12*2504 


263 


QUOLST 


1 


T 




24 


30 


COPRH 


6 


BACKUP 


24 


RN 




1103 


31 


10*2162 


116 




3+8 


~C 




27 


32 


226*4563 


P14J64 


QUASAR 


12 


HB 







33 


30*4661 


P1.1.J46 


QUASAR 


25 


HB 


SW 





34 


226*4646 


131 


UED 


4+13 


TI 




1 


35 


226*4563 


P15J64 


LOGCSP 


1+3 


"C 




'.■> 


36 


10*5064 


253 


FILCOM 


4+4 


T 




5 J 24 


37 


35*5135 


325 


OPSER 


2+5 


T 




32 


38 


60*3733 


134 


IQSORT 


46+44 


~C 




2 


39 


30*5134 


DDT 


20 


TI 






3 


40 
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Function 

The TECO command opens an already existing file on disk for 
editing with TECO. Refer to the TECO manual in the DECsystem-10 
Software Notebooks . 

Command Format 

TECO dev:file.ext [directory] 

dev: is the device or file structure name containing the 
existing file. If omitted, DSK: is assumed. 

file.ext is the file name and the file name extension of the 
existing file. If omitted, the arguments of the last 
EDIT-class command are used. 

[directory] is the directory name in which the file appears. 
If omitted, your directory is assumed. 

You can pass switches to TECO by preceding the switch with a 
slash in the TECO command string. When COMPIL interprets 
the command string, it passes the switches on to TECO. 

Characteristics 

The TECO command: 

Places your terminal in user mode. 

Runs the TECO program, destroying your core image. 

Example 

♦ TECO LOGOUT ♦MIC ^ 

L'2K CoreH 



. TECO PRINT. MIC ^ 
C2K Co re 3 



1 This command runs the COMPIL program, which interprets the 
commands before running TECO. 
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Function 

The TIME command causes the system to type the total running time 
since the last time you issued the TIME command, followed by the 
total running time used by the job since it was initialized 
(logged-in) , followed by the integrated product of running time 
and core size (KILO-CORE-SEC=) . Time is typed in the following 
format: 

hh:mm: ss.hh 

where 

hh = hours 

mm = minutes 

ss.hh = seconds to nearest hundredth. 

Interrupt level and job scheduling times are charged to whichever 
user was running the system job when the interrupt or 
rescheduling occurred. 

NOTE 

If automatic runtime is enabled via the SET WATCH 
command, the incremental runtime is usually 0. 



Command Format 

TIME job 

job is the job number of the job whose timing is desired. 
If job is omitted, the job to which the terminal is attached 
is assumed. In this case, the monitor types out the 
incremental runtime (runtime since the last TIME command) as 
well as the total runtime since the job was initialized. 



Characteristics 

The TIME command: 



Leaves your terminal in monitor mode. 

Does not require LOGIN when requesting time for another 

user's logged in job. 



Example 



» TlME ^y The command is given for the first time after 

4*55 LOGIN; therefore, the incremental time equals 

2.1*36 the total time since LOGIN. 
KIL0--C0RE--SEO175 

♦ TIM^y 

0,00 

21,36 

KI1..0---CQRE--SEO175 
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WONDER. REL DSKC! <27r 40721 
WONDER. QOR 



♦ TIME ^ 

0*70 " 

22.06 

KIL0-C0RE-SEC«183 
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Function 

The TPUNCH command is used to place entries into the paper-tape 
punch output queue. This command is equal to the following form 
of the QUEUE command: 

QUEUE PTP: jobname = list of input specifications. 

Command Format 

TPUNCH jobname = list of input specifications 

jobname is the name of the job being entered into the queue. 
The default is the name of the first file in the request not 
the name of the first file given. These differ when the 
first file given does not yet exist. 

input specifications is a single file specification or a 
string of file specifications, separated by commas, for the 
disk files being processed. A file specification is in the 
form dev: file. ext [directory] . 

dev: is any disk file structure to which PTPSPL will have 
access; the default is DSK:. 

file. ext is the name(s) of the file(s). The file name is 

optional. The default for the first filename is *, the 

default for subsequent files is the last filename used. The 
extension can be omitted; the default is .PTP. 

[directory] is a directory to which you have access; your 
directory is assumed if you do not specify a directory. 

The wildcard construction can be used for the input 
specifications. 

You can obtain the listing of entries in the paper-tape punch 
queue for specific project-programmer numbers by following the 
command with the desired project-programmer numbers enclosed in 
square brackets (e.g., TPUNCH [400,27]). If no arguments appear 
in the command string (i.e., you give only the command name ), 
all entries in the paper-tape punch queue for all jobs are 
listed. 

You can specify switches as part of the input specification that 
aid in the construction of the queue entry. These switches are 
divided into three categories: 

1. Queue-operation - Only one of these switches can be placed in 
the command string because they define the type of queue 
request. The switch used can appear anywhere in the command 
string. 

2. General - Each switch in this category can appear only once 
in the command string because these switches affect the 
entire request. The switch used can appear anywhere in the 
command string. 

3. File control - Any number of these switches can appear in the 
command string because they are specific to individual files 
within the request. The switch used must be adjacent to the 
file to which it applies. If the switch precedes the 

2-242 



TPUNCH Command (Cont.) 



filename, it becomes the default for subsequent files. For 
example, the command string 

TPUNCH FILEA, FILEB/DISP : REN , FILEC 

indicates that the DISPOSE switch applies only to FILEB. The 
command string 

TPUNCH /DISP:REN FILEA, FILEB, FILEC 

indicates that the DISPOSE switch applies to all three files. 

The following switches can be used with the TPUNCH command. Note 
if an argument to a switch is omitted, the colon preceding the 
argument must also be omitted. Otherwise the argument is assumed 
to be zero and not the default value. 

See the QUEUE command for a complete list of switches and their 
functions. 

Characteristics 

The TPUNCH command: 

Leaves the terminal in monitor mode. 

Runs the QUEUE program, thereby destroying your core image. 

Does not require LOGIN when only queued listings are 

desired. 

Examples 

* T P U N C I -I S E N D M P ♦ R E L / T A P E t B I N A R Y / C P I E S i 3 ~J 

Punch 3 copies, in binary mode, of the file DSK:SENDMP.REL. 
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Function 

The TYPE command directs PIP to type the contents of the named 
source file(s) on your terminal. Note that if more than one file 
is requested in the command string, the files are typed out one 
after another with no indication of the beginning and ending of a 
file. 

Command Format 

TYPE list 

list is a single file specification or a string of file 

specifications separated by commas. The file name 

(including any extension) is required for a directory 
service. 

In addition, the full wildcard construction can be used for 
the file name and/or the extension. 

Switches can be passed to PIP by enclosing them in 
parentheses in the TYPE command string. When COMPIL 
interprets the command string, it passes the switches on to 
PIP. 

Characteristics 

The TYPE command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, destroying your core area. 

Examples 



♦ TYPE. LOGOUT ♦ MIC ~J 
delete Xuctno 

delete tt.iriem 

di r 

. TYPE PR I NT. M I C ^ 
PRINT LLJ«C0M1.MEM 

PRINT ll:=comii.mem 

PRINT LL:~C0M12»MEM 
PRINT LLJ^C0M2A.MEM 
PRINT LL.J~C0M2B.MEM 
PRINT LLJ=C0M2C.MEM 
PRINT LLt«C0M3 # MEM 

. TYPE SWITCH. I NI V 

00100 sos/save* lO/isave.40 



1 This command runs the COMPIL program, which interprets the command 
before running PIP. 
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Function 

The UNLOAD command rewinds and unloads a tape, either magnetic 
tape or DECtape. When unloading magnetic tape, WATCH statistics 
are printed on the operator's terminal. These statistics are 
also printed on your terminal by default. 

Command Format 

UNLOAD dev: 

dev: is a magnetic tape (MTAn) or a DECtape (DTAn) . 

Characteristics 

The UNLOAD command: 

Leaves the terminal in monitor mode. 

Runs the COMPIL program, destroying your core image. 



Examples 

♦ UNLOAD DTA017 ^ 

♦ 

♦ UNLOAD MTA013^ 
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Function 

The USESTAT command returns status information pertinent to your 
job. This status information is printed on one line in eight 
columns. The information given includes: 

incremental day time in seconds 
incremental run time in seconds 
incremental disk reads 
incremental disk writes 
program name 
core size 
job state 
program counter (PC) 

Refer to Section 1.3.1 for a description of the status 
information returned as a result of the USESTAT command (or "T) . 
An ampersand (&) is printed out after the JOBSTATE if the job is 
loaded in core. 

The results obtained from issuing the USESTAT command may also be 
obtained by issuing a CTRL/T (~T) . CTRL/T can be issued at user 
level as well as at monitor level. 

The PAGE function .PAGEA returns more information (see UUOSYM) . 

Command Format 

USESTAT (or CTRL/T) 

Characteristics 

CTRL/T 

Does not change the state of the terminal. 
USESTAT: 

Leaves the terminal in monitor mode. 
Example 

♦ us^y 

DAY J J 37 1 57 RUN: 4* (35 RDJ1111 WRJ775 SOSX 8+23P T PC J 404570 
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Function 

The VERSION command prints the version number of the program in 
your core area (i.e., the last program you ran implicitly or 
explicitly) . One use of this command is to determine the program 
that output a message to you. If the terminal is still in user 
mode (i.e., a character other than a period was output) after the 
message, you can type the following 

"C (two "Cs if the program is not waiting for input) 
.VERSION 

The monitor returns with the name of the program in core (i.e., 
the one presumed to have output the message) and the version 
number of that program. After receiving the information, you can 
type .CONT to return the terminal to user mode. If the message 
was a fatal message (i.e., a period was output after the 
message). CTRL/C need not be typed since the terminal is already 
in monitor mode. In most cases, you cannot type .CONT after a 
fatal error message. 

The version number is obtained from .JBVER and .JBHVR in the job 
data area and is printed in standard format. Similar output is 
automatically generated by the SET WATCH VERSION command (refer 
to the SET WATCH command description) . The output from these two 
commands is in one of the following representations: 

low + high The low and high segments are different. 

low There is only a low segment. 

low + The low and high segments are the same. 

+ A GETSEG monitor call has been performed to a 

high segment that matches the low segment. 

+ high 1 A GETSEG UUO has been done to a high segment 
that does not match the low segment. 

blank The high segment has been released. 

With the VERSION command, the low and high segments are 
represented in the format 

name version 

With the SET WATCH VERSION command, the low and high segments are 
represented in one of three formats: 

name version The program is not from SYS; 

:name version The output is the result of a SETNAM UUO 

(e.g., at the end of loading). 

S:name version The program is a program loaded from the 

system device (actual SYS: not logical 
device SYS: ) 



Output only from the SET WATCH VERSION command. 
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The name is a SIXBIT name and the version is in standard format. 
When printing the version number, the standard format is: 

major version minor version (edit) - group who modified program last 

The major version is octal; the minor version is alphabetic; 
the edit is octal and enclosed in parentheses; and the group who 
last modified the program is octal and preceded by a hyphen 
(0 = DEC development, 1 = all other DEC personnel, and 
2-7 = customer use). There are no spaces separating the items, 
and if an item is zero, it does not appear in print. The 
parentheses and hyphen also do not appear in print if the 
corresponding item is zero. The following are examples of 
version numbers output in standard format. 

10B(335)-1 major version 10, minor version B, edit 
number 335, group that modified program last 
1. 

7(5) major version 7, minor version 0, edit number 

5, group that modified program last 0. 

54A major version 54, minor version A, edit 

number 0, group that modified program last 0. 

When running under a virtual memory system, DAEMON will be called 
on execution of the VERSION command if the first page of the high 
segment is paged out. 

Command Format 

VERSION 

Characteristics 

The VERSION command: 

Leaves the terminal in monitor mode. 
Examples 

♦ R TECO ^y 

» VERS I ON ^7 
TECO 24(202) + 

. R SYSTAT ^y 

. VERSION -^ 
SYSTAT 473A<223) 

* R SOS ^ 

. VERSION ^ 
SOS 21 CI 34) 

♦ INITIA L 

♦ VERSION ^ 
INITIA 7(146) 
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Function 

The WHERE command enables you to determine: 

1. the node-id 

2. the node number 

3. the software I.D. (monitor name) 

4. the creation date of the monitor software 

of the node at which a specific peripheral device is located. If 
the node of a particular terminal is requested, the information 
returned is that of the physical location of the terminal. The 
information may or may not be that of the controlling job. This 
depends on whether or not you have changed your job's logical 
location by means of the LOCATE command. 

When the WHERE command does not provide sufficient user 
information, the following additional inputs are required: 

1. physical device name (both generic and logical); 

2. physical line number (for network TTYs) ; 

3. NOT CONNECTED entry (if the network TTY is not connected.) 

Command Format 

WHERE devn: 

dev is any physical name and n is the unit number. 

where OPR: allows you to find the location of the 

controlling job thru the OPSER program functions. 

Characteristics 

The WHERE command: 

Leaves the terminal in monitor mode. 

Does not require LOGIN. 

Allows for an optional colon after the device name. 

Examples 

* WHERE L.PT260 

NODE KL 1026 (26) SCLIZA KL10 SYS* 1026 07-24 -77 LPT260 
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Function 

The ZERO command clears the directory of the output device. This 
command is equal to the following PIP command string: 

dev: /Z = 

Command Format 
ZERO dev: 

dev: is a DECtape (DTAn) or a disk (DSK) . This argument is 
required. 

A directory name can be specified with ZERO DISK: and if 
you have access to the specified directory, the directory is 
zeroed. If you do not specify a directory, your directory 
is assumed. 

The only acceptable abbreviation of this command is ZER. 

Characteristics 

The ZERO command: 

Leaves the terminal in monitor mode. 

Runs the PIP program, destroying your core image. 

Examples 

♦ZERO DTA014J 

♦ZERO DSK J 

♦ ZERO DSK I <2? y 4072> 



1 This command runs the COMPIL program, which interpret the command 
before running the PIP program. 
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The following conventions are used in describing the system diagnostic 
messages: 

dev a legal device name. 

file structure name a legal file structure name. 

file.ext a legal filename and extension. 

adr a user address. 

n a number. 

abc a disk unit or drive. 

x an alphabetic character. 

switch a switch. 

Most messages returned to you fall in one of three categories. These 
categories are determined by the beginning character of the message. 

? at the start of the message indicates a fatal error message. 
% at the start of the message represents an advisory or warning 

message. 
[ at the beginning of the message indicates a comment line. 

(Note that the ONCE-only messages have been removed from this section 
and placed in ONCE.RNO in the DECsystem-10 Software Notebooks.) The 
user can also employ the VERSION monitor command to determine the 
program that output the message. If the terminal is still in user 
mode (i.e., a character other than a period was output after the 
message) , type the following 

~C (two "Cs if the program is not waiting for input) 
.VERSION 

The monitor returns with the name of the program in core (i.e., the 
one presumed to have output the message) and the version of that 
program. After receiving the information type .CONT to return the 
terminal to user mode. If the message was a fatal message (i.e., a 
period was output after the message), ~C need not be typed since the 
terminal is already in monitor mode. In most cases, the user cannot 
type .CONT after a fatal error message. 

The descriptive text given with the message indicates what action you 
should take when you receive the message. You can, if necessary, 
notify the operator of any problems by issuing the SEND, PLEASE, or R 
GRIPE command. 
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3.1 SYSTEM DIAGNOSTIC MESSAGES 

The typein is typed back preceded and followed by ?. 

The monitor encountered an incorrect character (e.g., a letter in 
a numeric argument). The incorrect character appears immediately 
before the second ?. 

For example: 

.CORE ABC 
?CORE A? 

ACCOUNTING SYSTEM FAILURE... 

A program could not append an entry to the accounting file. 
Notify the operator. (LOGIN, LOGOUT) 

7ADDRESS CHECK FOR DEVICE dev 

1. The monitor checked a user address on a UUO and found it to 
be too large (>C(.JBREL)) or too small (<C ( . JBPFI ) ) ; in 
other words, the address lies outside the bounds of the user 
program. 

2. The SAVed file is too large for the core assigned, or the 
file is not a core image file. (GET) 

7ALREADY ASSIGNED TO JOB n 

The device is already assigned to another user's job (job n) . 

unit-id ALREADY MOUNTED ON unit 

You requested a drive of an already mounted file structure to be 
mounted or you requested a drive other than the one on which the 
file structure is mounted. (MOUNT) 

7AMBIGU0US ABBREVIATION 

A command or switch has been abbreviated to the point that it is 
not unique. (COMPIL) 

?dev: APPARENT UFD PROTECTION FAILURE 

Your attempt to delete a file has failed because of a UFD 
protection. As a result, KJOB exits to monitor level. (KJOB) 

PARGS ARE: DAY, RUN, WAIT, READ, WRITE, VERSION, ALL, NONE 

You either did not type an argument or typed an illegal argument 
in the SET WATCH command string. 

dev:ASSIGNED 

The device has been successfully assigned to the user's job. 
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7ASSIGNED TO JOB n(l), n(2), ... 

If there is more than one device of the type specified, the 
numbers of the other jobs that have the same type of device are 
output, unless the user assigning the device has all the devices 
of the specified type. In this case, 7DEVICE ASSIGNED TO JOB is 
output. 

7ATTACH TO USER JOB FAILED 

DAEMON could not attach to the user's job. (DAEMON) 

?BAD DIRECTORY FOR DEVICE DTAn 

The system cannot read or write the DECtape directory without 
getting some kind of error. This error often occurs when the 
user tries to write on a write-locked tape or use a DECtape that 
has never been written on. 

PBATCH ONLY 

The command issued can only be given by a batch job. 

BLOCK NOT FREE 

M specifies a unit or file structure logical block that is not 
free. (ALCFIL) 

n BLOCKS ALREADY ALLOCATED 

The file already exists. The new specification replaces, rather 
than updates, the old specification. (ALCFIL) 

?nlK BLOCKS OF CORE NEEDED 

Your current core allocation is less than the contents of .JBFF. 

7BOMB OUT 

The location within INITIA that detected the error will be in AC 
15 and the console lights. (INITIA) 

7BOOTSTRAP LOADER IS NOT IN COPY; TRY/L 

An attempt was made to write the bootstrap loader onto a DECtape 
via the /T switch before the loader was loaded into a core buffer 
and preserved with the COPY core image. (COPY program) 

PBOOTSTRAP LOADER WILL NOT FIT IN 3 BLOCKS 

Your bootstrap loader is too big to fit into blocks 0, 1, and 2 
of the output DECtape. (COPY program) 
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7BUFFER CAPACITY EXCEEDED AND NO CORE AVAILABLE 

The buffer is not large enough to handle the number of lines 
required for looking ahead for matches, and additional core is 
not available. (FILCOM) 

?BUSY 

The terminal addressed is not communicating with the monitor 
(i.e., it is accepting a command or returning output from a 
command). The operator's terminal is never busy. (SEND, JCONT) 

7CANN0T DO I/O AS REQUESTED 

Input (or output) cannot be performed on one of the devices 
specified for input (output). For example, input may have been 
requested for a device that can only do output. (MAKLIB) 

7CANN0T DO OUTPUT TO DEVICE dev 

Output was attempted to a device that can only do input, or to a 
device assigned a logical name. (QUEUE) 

%CANNOT OVERRIDE PPN IMPLIED BY DEVICE 

You specified a project-programmer number in a file specification 
in his FILE F or FILE Z command that is in conflict with the 
project-programmer number associated with the device. For 
example, the file specification, NEWrPOOH. BAH [12,144] , would 
generate this message since "NEW:" implies the project-programmer 
number [1,5]. The project-programmer number specified by you is 
ignored. (FILE) 

7CANNOT PROCESS EXTERNAL SYMBOLS 

External symbols were encountered while loading the bootstrap 
loader with the /L switch. (DTCOPY program) 

?CANNOT PROCESS HIGH SEG'S 

While loading the bootstrap loader with the /L switch, high 
segment code was encountered. (DTCOPY program) 

7CANNOT REATTACH FROM A BATCH SUBJOB 

Batch jobs are not allowed to reattach their jobs. (REATTA) 

PCAN'T ACCESS QUEUE - name MUST NOT BE A LOGICAL NAME 

The structure named contains the operator request queue (3,3.UFD) 
and must not be the logical name for some other structure. 
(MOUNT) 
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?CAN'T ACCESS QUEUE - file structure name MUST NOT BE LOCKED OR WRITE 
PROT. 

The named structure is being used to queue requests to the 
operator and therefore may not be locked or write-protected. 
SETSRC may be used to change the protection. (MOUNT, DISMOUNT, 
FILE) 

PCAN'T ACCESS SYSTEM FILES 

ACCT.SYS could not be read. Only the operator may LOGIN until 
ACCT.SYS is ready. Consult the operator. (LOGIN) 

PCAN'T ADD TO YOUR FILE STRUCTURE SEARCH LIST n 

n is the error code from STRUUO when trying to add a file 
structure to search list. (LOGIN) 

?file-structure name CAN'T ADD TO YOUR FILE STRUCTURE SEARCH LIST n 

"n" is the error code returned from the STRUUO which is trying to 
add this structure to the user's search list. See the STRUUO UUO 
error codes in the DECsystem-10 Monitor Calls manual and in the 
UUOPRV specification. This is a system error and therefore is 
not a direct fault of the user. It is typed for potential 
diagnostic use. Consult the system administrator. (MOUNT) 

PCAN'T ATT TO JOB 

The project-programmer number specified is not that of the owner 
of the desired job, the project-programmer number was not given 
when it was required, or the PASSWORD given was incorrect. 
(ATTACH) 

Pdev CAN'T BE REASSIGNED 

1. The job's controlling terminal cannot be reassigned, or 

2. the logical name would be duplicated, or 

3. the logical name is a physical device name in the system and 
the job reassigning the device is either logged-in under a 
different project-programmer number or does not have operator 
privileges. (REASSIGN) 

PCAN'T CONTINUE 

The job was terminated due to 

1. all ERROR IN JOB messages (except for HALT)., 

2. the EXIT UUO, 

3. the CLOSE command, or 

4. the REA command when the device was INITed, and the user 
attempted to continue his program at the point at which I/O 
was terminated. The job cannot be continued. 
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CAN'T CREATE NEW FILE STRUCTURE SEARCH LIST 

The monitor cannot create a new file structure search list. 

PCAN'T DECIPHER THAT 

There is a syntax error in the command string. (MOUNT, DISMOUNT, 
FILE) 

CAN'T DET DEV 

The user is not logged-in under [1,2]. 

?CAN'T ENTER OUTPUT FILE n file descriptor 

The ENTER to write the output file failed; n is the disk error 
code. (DUMP) 

?CAN'T EXPAND TABLE xxxx 

The DUMP program ran out of core in attempting to expand the 
indicated table. (DUMP) 

?CAN'T FIND INPUT FILE n file descriptor 

DUMP cannot locate the file specified as the input file; n is 
the disk error code. (DUMP) 

PCAN'T FIND FILE file.ext 

The specified file could not be found. 

PCAN'T FIND STRLST.SYS 

The system is unable to locate or access STRLST.SYS, the system 
file that contains necessary information about the structures 
known to the system. Consult the system administrator. (MOUNT) 

PCAN'T GET SWAPPING PARAMETERS 

DAEMON tried to obtain the job's swapping parameters and failed. 
(DAEMON) 

PCAN'T GET SWAPPING POINTER FOR JOB 

DAEMON tried to obtain the pointer to the user's job on the 
swapping space and could not because the GETTAB UUO failed. 
(DAEMON) 

PCAN'T GET USERS PPN 

DAEMON tried to obtain the user's project-programmer number and 
could not because a GETTAB UUO failed. (DAEMON) 
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?CAN'T OPEN file structure name 

The file structure is mounted but cannot be opened. No UFD is 
created, though one may already exist. (LOGIN) 

?file-structure name CAN'T OPEN 

The specified device cannot be OPENed; either because it does 
not exist or because the OPEN UUO failed. (MOUNT) 

?CAN'T OPEN DEVICE dev 

The specified device does not exist or it is assigned to another 
user. (DAEMON) 

PCAN'T OPEN SWAP UNIT abc 

DAEMON attempted to use the indicated swapping unit and failed. 
(DAEMON) 

?CAN'T READ STRLST.SYS 

A read error occurred when the system tried to read STRLST.SYS, 
the system file that contains necessary information about the 
structures known to the system. Consult the system 
administrator. (MOUNT) 

?file structure name CAN'T REDEFINE FILE STRUCTURE n 

"n" is the error code returned from the STRUUO which is 
attempting to redefine the structure to include the user. See 
the STRUUO UUO error codes in the DECsystem-10 Monitor Calls 
manual and in the UUOPRV specification. This is a system error 
and therefore is not a direct fault of the user. It is typed for 
potential diagnostic use. Consult the system administrator. 
(MOUNT) 

?file structure name CAN'T REMOVE FILE STRUCTURE FROM SEARCH LIST n 

"n" is the error code returned from the STRUUO which is 
attempting to remove the structure from the user's search list. 
See STRUUO UUO error codes in the DECsystem-10 Monitor Calls 
manual and in the UUOPRV specification. This is a system error 
and therefore is not a direct fault of the user. It is typed for 
potential diagnostic use. Consult the system administrator. 
(DISMOUNT) 

?CAN'T RENAME-FILE PRESERVED 

An attempt was made via the /DISPOSE .-RENAME switch to delete a 
preserved file (i.e., a file whose owner's field is greater than 
0). (QUEUE) 
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PCAN'T SET OUR SEARCH LIST 

DAEMON tried to set its search list and failed in its attempt. 
(DAEMON) 

?CAN'T SET SEARCH LIST = USER'S 

DAEMON attempted to set its file structure search list to be the 
same as the user's search list. (DAEMON) 

7.CMLLRE (n) FILE WAS NOT FOUND - filename 

The specified was not found on the user's directory. 

PCOMMAND ERROR 

General catch-all error response for most commands. The syntax 
of the command is in error, and the command cannot be deciphered. 

In FILCOM, one of the following errors occurred in the last 
command string typed. 

1. There is no separator ( - or =) between the output and input 
specifications. 

2. The input specification is completely null. 

3. The two input files are not separated by a comma. 

4. A file descriptor consists of characters other than 
alphanumeric characters. 

5. FILCOM does not recognize the specified switch. 

6. The project-programmer number is not in standard format, 
i.e. , [proj,prog] . 

7. The value of the specified switch is not octal. 

8. The first input file is followed by a comma but the second 
input file is null. 

PCOMMAND SWITCH REQUIRED 

The given command string requires a MAKLIB command code. 
(MAKLIB) 

7COMMAND SYNTAX ERROR 
TYPE /H FOR HELP 

An illegal command string was entered. (GLOB) 

n COMMANDS IN QUEUE 

The request typed by you has been placed in a queue to be 
performed when possible. n is the number of requests in the 
queue for all users. (FILE, MOUNT, DISMOUNT) 
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7COMMA REQUIRED IN DIRECTORY 

A project-programmer number has been specified without the 
separating comma. (DUMP, QUEUE) 

CONT BY OPR 

The job has been continued by the operator. This message appears 
on the console of the job being continued. (JCONT) 

7C0NTR0L AND LOG FILES MUST BE DISTINCT 

The control file cannot be the same file as the log file. 
(QUEUE) 

?2K CORE NEEDED AND NOT AVAILABLE 

FILCOM needs 2K of core to initialize I/O devices and this core 
is not available from the monitor. (FILCOM) 

%CPUn OPRl ACTION REQUESTED 

The Job's CPU specification includes a CPU which is not running 
or is not scheduling jobs. The monitor remembers the 
specification and uses the CPU as soon as it is started. If at 
least one CPU is running, the message is printed only once, since 
the job can run on another CPU. 

7DAEMON FILE MUST BE WRITTEN ON A DISK 

The device specified was a nondisk device. (DAEMON) 

7DAEM0N NOT RUNNING 

The DAEMON program has not been initialized. It must be started 
by the operator to allow the DUMP and DCORE commands to operate. 
(DUMP, DCORE) 

7DETACH UUO FAILED 

DAEMON could not detach itself from the TTY. Note that DAEMON 
does not detach itself if it is loaded with DDT. (DAEMON) 

7DATA ERROR ON DEVICE PTR 

A read error has occurred on the paper-tape reader. 

7DESTINATION DEVICE ERROR 

An I/O error occurred on the output device. (GLOB) 
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PDEVICE CAN'T BE REASSIGNED 

1. The job's controlling terminal cannot be reassigned, 

2. the logical name would be duplicated, or 

3. the logical name is a physical device name and the job 
reassigning the device is either logged in under a different 
project-programmer number or is not the operator. 

PDEVICE ERROR ON OUTPUT DEVICE 

A write error has occurred on the output file. (MAKLIB) 

PDEVICE INIT FAILURE 

The specified device has been assigned to another job or does not 
exist. 

PDEVICE MUST BE A DECTAPE 

The only device that can be specified in the DTCOPY command 
string is the DECtape. 

PDEVICE NOT ASSIGNABLE 

A non-privileged user cannot assign the requested device because 
it belongs to the restricted pool of devices. The user should 
try to assign the device with the MOUNT command. (ASSIGN) 

PDEVICE NOT AVAILABLE 

Specified cannot be initialized because another user is using it 
or because it does not exist. 

PDEVICE WILDCARD ILLEGAL 

The wildcard construction cannot be used in the device 
specification. (DUMP, QUEUE) 

PDIALOG MODE NOT SUPPORTED 

The capability of interactive dialogue with the user has not been 
implemented. (QUEUE) 

PDIRECTORY FULL ON OUTPUT DEVICE 

There is no room in the file directory on the outut device to add 
the updated file (nondisk devices only) . (MAKLIB) 

device name DISMOUNTED 

The DISMOUNT command has completed. 
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Pdevice name DISMOUNT INCOMPLETE 

The DISMOUNT command was unsuccessful. In most cases, the 
reasons for failure have already been listed by nonerror 
messages. 

DON'T KNOW CITY LINE NUMBER 

The DCORE command cannot be typed on CTY. (DAEMON) 

7DOUBLE DEVICE ILLEGAL 

Two device names appeared in a row without an intervening 
filename, or two colons appeared in a row, e.g., LPT:PTP: or 
DSKA ::FILEX. (DUMP, QUEUE) 

7DOUBLE DIRECTORY ILLEGAL 

Two directory names cannot appear without an intervening 
filename. (DUMP, QUEUE) 

7DOUBLE EXTENSION ILLEGAL 

Two extensions cannot appear without an intervening filename or 
comma. (DUMP, QUEUE) 

7D0UBLE FILENAME ILLEGAL 

Two filenames appeared in a row, or two periods appeared in a 
row; e.g., Q TEST1 TEST2 or TESTX.MAC. (DUMP, QUEUE) 

?DPA n ILLEGAL UNIT 

The user has specified a drive that does not exist in the system. 
(MOUNT) 

%DRTLKE NON-EXISTENT FILE filename 

A file was specified in the command string that is not present in 
the user's default directory. 

?DSK CAN'T BE REASSIGNED 

An attempt was made to reassign the prototype disk device data 
block (DDB). 

7DSKCHR FAILURE n ON UNIT abc 

The DSKCHR UUO gave an unexpected error return; n is the disk 
error code. Notify the operator. (DAEMON, KJOB) 
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7ENTER ERROR n 
7DIRECTORY FULL 

No additional files can be added to the directory of the output 
device; n is the disk error code. (GLOB) 

7ENTER FAILURE 

The DECtape directory is full (i.e., there is no room for the 
file to be written on the DECtape). 

?ENTER FAILURE n 

The output filename is null; n is the error code for an illegal 
filename (nondisk devices only) . (MAKLIB) 

7ENTER FAILURE IN QUEUE MANAGER 

QUEUE was unable to enter the files into the output queue. 
(QUEUE) 

7ENTER FAILURE n ON DAEMON FILE 

The ENTER to write the file failed; n is the disk error code. 

7ENTRY BLOCK TOO LARGE PROGRAM name 

The entry block of the named program is too large for the MAKLIB 
entry table, which allows for 100 entry names. MAKLIB can be 
reassembled with a larger table. (MAKLIB) 

7ERROR CLOSING OUTPUT, STATUS = n 

An I/O error occurred while closing the file on disk; n is the 
disk error code (DUMP) . 

TERROR IN JOB 

Usually this message indicates an error has occurred in the 
monitor. The message appears on either the user's terminal or 
the operator's terminal and precedes a one-line description of 
the error. 

7ERROR IN DETACHED JOB n [prog name] 

A fatal error occurred in the detached job or in the monitor 
while servicing the job. This message appears only on the 
operator's terminal (OPR) and precedes a one-line description of 
the error. 



PERSATZ DEVICE ersatz device 

Attempt was made to remove an ersatz device from the search list 
with R. (SETSRC) 
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?EXCEED LOG-OUT m QUOTA BY n BLOCKS 

The total number of blocks for all the user's files exceeds the 
maximum permitted value (mmm) by the indicated amount (nnn) . If 
you are the operator, the DISMOUNT proceeds. Otherwise, this 
message is followed by the message "7DISMOUNT INCOMPLETE". Then, 
you may use PIP or the DELETE command to remove files. But, 
until the number of blocks is under the limit, you cannot 
dismount a structure or log out. (DISMOUNT) 

?EXECUTION DELETED 

A program is prevented from being executed because of errors 
detected during assembly, compilation, or loading. Loading is 
performed, but the loader exits to the monitor without starting 
execution. (LOADER) 

7EXPECTED FORMAT IS nnnK = 16K to 256K 

The core-bank specified while processing the /T switch is not 
within the acceptable range or does not terminate with the letter 
K; e.g., 32 is not acceptable; 32K is. (COPY program) 

file structure name FILE ERRORS EXIST 

One of the files in a file structure has an error status, as 
flagged in the UFD of that file structure. (LOGIN) 

7FILENAME ALREADY IN USE 

The specified file already exists. (COMPIL) 

7FILENAME REQUIRED FOR INPUT QUEUE 

A file cannot be entered into the Batch input queue without a 
filename. (QUEUE) 

?filename FILE NOT FOUND 

File specified cannot be located. 

7FILE n NOT IN SAV FORMAT 

You indicated via the /X switch that the file is to be expanded 

but the specified file is not in compressed file format. n is 

either 1 or 2 indicating the first file or the second file. 
(FILCOM) 

?FILE n READ ERROR 

An error has occurred on either the first or second input device. 
(FILCOM) 
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?FILE REQUEST NOT QUEUED 

Your file request was not queued. Other messages give the 
reasons. (FILE) 

?FILE R ILLEGAL IF DSK: CONTAINS NO UFD 

You tried to do a FILE R command with a search list that has no 
device that is eligible to receive the recalled files. You 
should have at least one structure in your active search list 
that contains both a UFD and the status of /CREATE and /WRITE. 
You should adjust your search list with the SETSRC command and 
retry the FILE command. (FILE) 

%FILES ARE DIFFERENT 

The two input files specified in the command string are different 
(i.e., the two files are not two versions of the same file but 
are two different files) . (FILCOM) 

?FILE SWITCHES ILLEGAL IN OUTPUT FILE 

File switches cannot appear on the left of the equal sign, i.e., 
in the output specification. (QUEUE) 

?(3) FILE WAS BEING MODIFIED-f ile. ext 

Another user is modifying the file. (COMPIL) 

?(0) FILE WAS NOT FOUND-f ile . ext 

The named file could not be located. (COMPIL) 

7FORMAT OR READ ERROR IN AUXACC.SYS 

LOGIN unexpectedly found an end-of-file or an error in 
AUXACC.SYS. Notify the operator. (LOGIN) 

file. ext FOUND BAD BY FAILSAFE READING MTA 

The file in the file structure has an error status as flagged in 
the UFD of the file structure. (LOGIN) 

FROM JOB n 

An informative message telling you the job number to which the 
console was attached or from which the console is detaching. 
(ATTACH, DETACH) 

PGIVING BACK TOO MUCH CORE 

An internal problem in the DUMP program. Notify your system 
programmer or software specialist. (DUMP) 
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?HALT AT USER adr 

Your program executed a HALT instruction at adr. Typing CONTINUE 
resumes execution at the effective address of the halt 
instruction. 

file.ext HARDWARE DATA READ ERROR DETECTED 

The file has a hardware data read error flagged in the UFD of the 
file structure. (LOGIN) 

file.ext HARDWARE DATA WRITE ERROR DETECTED 

The file has a hardware data write error flagged in the UFD of 
the file structure. (LOGIN) 

%structure name HAS OTHER USERS-/REMOVE IGNORED 

The specified structure is still being used by other jobs. The 
structure is removed from your search list but is not physically 
dismounted. (DISMOUNT) 

?HAVE OPERATOR START OMOUNT, THEN TRY AGAIN 

The command area where your requests are stored does not exist. 
(FILE, MOUNT, DISMOUNT) 

?HUNG DEVICE dev 

If a device does not respond within a certain period after it is 
referenced, the system decides that the device is not functioning 
and outputs this message. 

PILLEGAL BLOCK TYPE dev: file.ext 

The block type used is not in the range 0-77. (MAKLIB) 

7ILLEGAL BLOCK TYPE 

While loading the bootstrap loader with the /L switch, an 
unrecognizable block type was encountered by DTCOPY. (DTCOPY 
program) 

? ILLEGAL COMMAND SYNTAX CHARACTER x 

The character x is used incorrectly in the command string. 
(QUEUE) 

? ILLEGAL DATA MODE FOR dev 

The data mode specified for a device in your program is illegal, 
such as dump mode for the terminal. (MAKLIB) 
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?ILLEGAL DEVICE - dev: 

you specified a file structure name that is not a disk. (FILE) 

drive ILLEGAL DRIVE NAME 

The drive requested by the user is not one recognized by the 
system. (MOUNT) 

?drive ILLEGAL DRIVE NAME 

The drive specified by the user is in conflict with the unit or 
controller type required by the units of the file structure. 
(MOUNT) 

?(0) ILLEGAL FILENAME 

A filename of zero was specified. (MAKLIB) 

7ILLEGAL IN BATCH JOB 

The ATTACH, DETACH, SEND, CCONT, and CSTART monitor commands 
cannot be used by a batch job. 

7ILLEGAL JOB NUMBER 

The job number is too large or is not defined in this 
configuration. 

? ILLEGAL NAME - name 

You specified a structure name that does not exist. (MOUNT, 
DISMOUNT) 

PILLEGAL QUEUE DEVICE 

The queue name specified cannot be used with the given switch. 
(QUEUE) 

7ILLEGAL QUEUE NAME xxx 

The queue is not of the system queues, or the queue is a logical 
name. (QUEUE) 

? ILLEGAL SWITCH 

A non-recognizable switch was used in the command string. (GLOB) 

7ILLEGAL TO CREATE REQUEST FOR SOMEONE ELSE 

Only the operator logged in under 1,2 can create queuing request 
for other users. (QUEUE) 
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?drive name ILLEGAL UNIT 

The drive specified by the user is not a valid drive name. 
(MOUNT, DISMOUNT) 

PILLEGAL UUO AT USER adr 

An illegal UUO was executed at user location adr. 

PILL INST. AT USER adr 

An illegal operation code was encountered in your program. 

PILL MEM REF AT USER adr 

An illegal memory reference was made by your program. If this 
message occurred on a memory write, the error is at adr-1 since 
the program counter has been advanced. If it occurred on a 
memory read, then the illegal instruction is probably in location 
adr. You should use the E command to first examine location 
adr-1 and then location adr in order to determine the illegal 
instruction. The index registers may also have to be examined. 

PINCORRECT VALUE FOR /WRITE SWITCH : xxx 

You specified the value "xxx" with the /WRITE switch. The only 
acceptable values are YES and NO. (MOUNT) 

? INPUT AND OUTPUT DECTAPES MAY NOT BE THE SAME DEVICE 

The COPY program prforms its operations on an input DECtape and 
an output DECtape. These DECtapes cannot be the same. (DTCOPY 
program) 

PINPUT (or OUTPUT) BLOCK TOO LARGE 

A DECtape block number greater than 1101 (octal) was encountered. 
(DTCOPY program) 

PINPUT (or OUTPUT) CHECKSUM OR PARITY ERROR 

A read (or write) error has been detected. (DTCOPY program) 

PINPUT DEVICE dev CANNOT DO OUTPUT AT USER adr 

Output was attempted on a device that can only do input (e.g., 
the card reader). 

PINPUT (or OUTPUT) DEVICE ERROR 

The DECtape control unit has detected the loss of data or a 
missed block. (DTCOPY program) 
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?INPUT DEVICE NOT A DISK 

The input specifications in a QUEUE command must be disk files. 
(QUEUE) 

7INPUT ERROR 

An I/O error occurred while reading a temporary command file from 
the disk. File should be rewritten. (COMPIL) 

7INPUT ERROR - file.ext FILE NOT FOUND 

The specified file could not be found on the input device. 
(FILCOM) 

PINPUT ERROR ON DEVICE dev: STATUS (nnnnnn) 

A data or device error occurred on input. (MAKLIB) 

7INPUT ERROR, STATUS = n 

An I/O error occurred while reading the file from disk; n is the 
disk error code. A new INPUT command causes a new LOOKUP to be 
done. (DUMP, DAEMON) 

7INPUT (or OUTPUT) PREMATURE END OF FILE 

When copying a DECtape, DTCOPY encountered the end of file before 
it expected it. This may happen when copying a PDP-9 DECtape to 
a DECsystem-10 DECtape. (DTCOPY program) 

7INSUFFICIENT CORE FOR QUEUE 

There is no enough core in system at the time of the KJOB command 
to make an output queue entry. (QUEUE) 

? INVALID ENTRY - TRY AGAIN 

# 

An illegal project-programmer number or password was entered and 
did not match identification in system. The user is to retype 
his project-programmer number and password. (LOGIN) 

?I/0 TO UNASSIGNED CHANNEL AT USER adr 

An attempt was made to do an OUTPUT, INPUT, OUT, or IN to a 
device that the user's program has not initialized. 

?X IS AN ILLEGAL CHARACTER SWITCH 

An illegal character or switch was encountered in the command 
string. (MAKLIB) 
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r'symbol IS A MULTIPLY DEFINED LOCAL 

The named symbol is in more than one symbol table with different 
values. (DUMP) 

?symbol IS AN UNDEFINED SYMBOL 

The named symbol is not in DUMP'S symbol table. (DUMP) 

? symbol IS AN UNDEFINED SYMBOL TABLE NAME 

The named symbol table has not been loaded with an XTRACT 
command. (DUMP) 

?JOB CAPACITY EXCEEDED 

1. This message is received by a user who attempts to login 
after the maximum number of jobs that the system has been set 
to handle has been initiated. The user should login at a 
later time. (LOGIN) 

2. This message is received when a system program must create a 
job in order to perform its operation and the maximum number 
of jobs has been initiated. (SYSTAT, HELP, ATTACH) 

3. This message may appear on rare occasions when an error made 
by the system hardware causes a reduction in the job capacity 
of the system. 

?JOB NOT WAITING 

The job specified is not waiting to be continued. (JCONT) 

JOB SAVED 

The output is completed. 

JOBn USER [p,p] LOGGED OFF TTY n AT hhmm dd-mm-yy 

DELETED <ALL> n FILES 

SAVED <ALL> n FILES m TOTAL BLOCKS USED 

ANOTHER JOB STILL LOGGED IN UNDER [p,p] 

RUNTIME n MIN m SEC 

This information is typed as you log off successfully. Note that 
m is total blocks allocated as opposed to blocks written. 
Therefore, it is always greater than or equal to the number of 
blocks written. Files are allocated in units of blocks called 
clusters. The system administrator selects the cluster size for 
each file structure, usually one block per cluster for FH file 
structures, and 5 or 10 blocks per cluster for DP file 
structures. (KJOB) 

7LANGUAGE PROCESSOR CONFLICT 

The use of the + construction has resulted in a mixture of source 
languages. (COMPIL) 
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?LEVEL D ONLY 

The command issued is available only in 5-series monitors. 

[LGNQTA structure IN: iiiiii OUT: oooooo USED; nnn] 

The monitor has computed the disk usage on structure to be iiiiii 
input file quota, oooooo output file quota, and nnn blocks used. 

[LGNRDU RECOMPUTING DISK USAGE] 

The monitor is recomputing the disk usage on the default 
directory/ before the user can successfully LOGIN. 

7LGTISK ILLEGAL SYNTAX IN KJOB COMMAND 

An illegal command syntax has been specified for a command to 
KJOB. (LOGOUT) 

7LGTCSK CONFLICTING SWITCHES IN KJOB COMMAND 

Conflicting switch-types have been specified to the KJOB command. 
(LOGOUT) 

%LGTURS UNRECOGNIZED SWITCH switch - IGNORED 

An illegal (unrecognizable) switch has been specified for KJOB, 
it is ignored. (LOGOUT) 

%LGTJWF JOBSTR UUO FAILED - NO QUOTA ENFORCED 

The JOBSTR monitor call was executed, and it failed; therefore, 
no quotas are in effect. (LOGOUT) 

%LGTCCW CAN'T CLEAR SOFTWARE WRITE-LOCK ON STRUCTURE structure 

You had structure software write-locked, and the STRUUO to clear 
this condition failed. This message is usually found by a 
%LGTURF message. (LOGOUT) 

[LGTWFI WAITING FOR structure UFD INTERLOCK] 

LOGOUT attempts to set the monitor UFD interlock before doing 
quota enforcement. If another job has it interlocked already, 
LOGOUT will wait. (LOGOUT) 

[LGTRDU RECOMPUTING DISK USAGE ON structure] 

Disk usage is being recomputed on the specified structure. 
(LOGOUT) 
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7LGTOUF OPEN UUO FAILED FOR structure 

The specified structure tried to execute an OPEN monitor call, 
but it failed. (LOGOUT) 

7LGTLQE structure LOGGED-OUT QUOTA nnn EXCEEDED BY nn BLOCKS 

Your allocation on the file structure named is greater than your 
logged out quota. The user must go through the CONFIRM dialogue 
and delete files until you are under the quota allowed to log 
Off. (KJOB, LOGOUT) 

%LGTULF ZSTRUCTURE UFD LOOKUP FAILURE nn 

A LOOKUP was executed on the specified structure, and it failed. 

%LGTURF structure UFD RENAME FAILURE nn 

A RENAME was executed on the specified structure, and it failed. 

DAEMON NOT RUNNING 
PLGTASF ACCOUNTING SYSTEM FAILURE DAEMON UUO FAILED 

ERROR CODE NO. 

An error occurred in the system accounting files, and the DAEMON 
UUO failed. Call the operator if you receive such a message. If 
the operator receives the message, continue the system for system 
debugging. 

PLINKAGE ERROR - RUN UUO 

An I/O error occurred while reading a program from the device 
SYS:. (COMPIL) 

%LISTING DEVICE OUTPUT ERROR, STATUS = 

The device specified for the output has an error. A new OUT 
command selecting a new file can be given or an OUT and APPEND 
command sequence to try again. (DUMP) 

7LISTING ENTER FAILURE n 

The ENTER to write the output file failed; n is the disk error 
code. (QUEUE) 

7LISTING OPEN FAILURE ON DEVICE dev 

The OPEN failed on device dev. (QUEUE) 

Pfile structure LOCKED OUT BY OPERATOR 

The operator has locked this structure, preventing any new 
accesses, in order that it may be removed. (MOUNT) 
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%LOG FILE DEVICE IS NOT DSK OR SPOOLED; WILL USE TTY 

The log file device is not a disk or spooled; therefore, KJOB 
assumes TTY. (KJOB) 

file structure name LOGGED OUT QUOTA n EXCEEDED BY m BLOCKS 

Your allocation on the file structure named is greater than your 
logged out quota. You must go through the CONFIRM dialogue and 
delete files until you are under the quota allowed to log off. 
(KJOB, LOGOUT) 

%LOGICAL NAME WAS IN USE, DEVICE dev ASSIGNED 

You previously assigned this logical name to another device. The 
logical name is cleared from the first device and assigned to the 
second. 

LOGICAL NAME IN USE (NAME IGNORED) 

You specified a logical name in your MOUNT command that is 
currently in use by the same job. MOUNT creates a unique logical 
name of the form "Mnnnnn" for this MOUNT request. (MOUNT) 

7LOGIN PLEASE 

A command that requires you to be logged in has been typed to the 
monitor; it cannot be accepted until your perform a LOGIN. 

PLOGIN PLEASE TO USE SWITCH CREATE 

You must be logged in to make a new entry into a system queue. 
(QUEUE) 

? LOOKUP ERROR n 
Pfile.ext FILE NOT FOUND 

The named file cannot be found in the directory on the specified 
device. (GLOB) 

PLOOKUP FAILED, 'BSLDR.REL' 

While processing the /L switch, COPY could not find the bootstrap 
loader named BSLDR.REL. (COPY program) 

? LOOKUP FAILURE 

The LOOKUP to read the disk file failed. This message is 
followed by a line explaining the reason for failure. (MAKLIB) 

?file structure name LOOKUP FAILURE n 

The LOOKUP to read the file failed; n is the disk error code. 
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LOOKUP FAILURE FOR AUXACC.SYS 

The system was unable to find AUXACC.SYS (one of the system's 
master accounting files) . The system is unable to determine 
quotas on your file structure. For MOUNT commands this means 
that no UFD can be created. (MOUNT, DISMOUNT) 

7LOOKUP FAILURE FOR INPUT FILE n file 

DUMP cannot read the input file. (DUMP) 

7LOOKUP FAILURE n ON DAEMON FILE 

The LOOKUP to read the DAEMON file failed; n is the disk error 
code. (DAEMON) 

%LOOKUP FOR HOME BLOCKS FAILED 

The system is unable to locate or access HOME. SYS on the mounted 
structure. Your job will continue, this allowing unformatted 
structures to be accessed. (MOUNT) 

7MAKLIB SYNTAX ERROR 

An illegal command string was entered; for example, the equal 
sign was omitted or a program name was specified for the output 
file. (MAKLIB) 

?MAX = n 

A value was specified for an argument that is greater than the 
maximum value (n) allowed. (DUMP) 

?MAY NOT LOGIN AS MFD PPN 

No one can login as [l r l] because this number is the 
project-programmer number of the MFD. (LOGIN) 

LOCAL 
REMOTE 
?MAY NOT LOGIN DATA SET 

BATCH JOB SUBJOB 

REMOTE CTY 

OPR 

ACCT..SYS entry does not permit the project-programmer number to 
login at the terminal that is being used. (LOGIN) 

?MAY NOT LOGOUT WITH FILE STRUCTURES FOR LOGICAL NAMES 

A file structure in the job's search list is assigned a logical 
name, and only physical device names are recognized. The user 
should deassign the logical names. (KJOB, LOGOUT) 
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?MEM PAR ERROR AT USER PC adr 

The processor detected a memory parity error in the low or high 
segment while the job was executing. The adr is the address of 
the PC stored by the hardware rather than the user address of the 
parity error. The operator also receives an error message giving 
the range of absolute addresses in case memory reconfiguration is 
necessary. DAEMON is awakened in order to record the pertinent 
information about the error for field service personnel. 

You must start a new copy of your program by typing the 
appropriate monitor command R, RUN, or GET. You should not start 
the program over by typing START, since the error is likely to 
reoccur or the program operate with incorrect data. 

7MKLBTL ENTRY BLOCK TOO LARGE, PROGRAM name 

The entry block of the named program is too large for the MAKLIB 
entry table, which allows for 1000 entry names. MAKLIB can be 
reassembled with a larger table. (MAKLIB) 

7MKLDFO DIRECTORY FULL ON OUPUT DEVICE 

There is no room in the file directory on the output device to 
add the updated (non-disk devices only) . (MAKLIB) 

7MKLDNA dev NOT AVAILABLE 

The specified device does not exist or is assigned to another 
user. (MAKLIB) 

7MKLEFI ENTER FAILURE 

The ENTER to write the disk file failed. This message is 
followed by a line explaining the reason for the failure. 
(MAKLIB) 

7MKLEFO ENTER FAILURE n 

The output filename is null; n is the error code for an illegal 
filename (non-disk devices only) . (MAKLIB) 

7MKLEOD DEVICE ERROR ON OUTPUT DEVICE 

A writer error has occurred on the output file. (MAKLIB) 

7MKLIBT ILLEGAL BLOCK TYPE dev: file. ext 

The block type used is not in the range 0-77, 1000-1777, or ASCII 
text from .TEXT pseudo-op. (MAKLIB) 

7MKLIDM ILLEGAL DATA MODE FOR dev 

The data mode specified for a device in the user's program is 
illegal, such as dump mode for the terminal. (MAKLIB) 
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7MKLIFN (0) ILLEGAL FILENAME 

A filename of zero was specified. (MAKLIB) 

7MKLMSE MAKLIB SYNTAX ERROR 

An illegal command string was entered; for example, the left 
arrow was omitted or a program name was specified for the output 
file. (MAKLIB) 

PMKLNEA NOT ENOUGH ARGUMENTS 

An insufficient number of files of one type has been specified. 
(MAKLIB) . 

%MKLNIN WARNING NO INDEX ON OUPUT FILE-CONTINUING 

The user has changed the structure of the indexed library file 
when deleting, appending, or inserting, thereby invalidating the 
index. The index has been removed from the new file. Reindexing 
is required. (MAKLIB) 

7MKLNIO CANNOT DO I/O AS REQUESTED 

Input, (or output) cannot be performed on one of the devices 
specified for input (output). For example, input may have been 
requested for a device that can only do output. (MAKLIB) 

7MKLNPS dev:file.ext/switch: ( ) NO PROGRAM NAME SPECIFIED 

The switch (/D or /R) used in the command string requires that a 
program name be given. (MAKLIB) 

PMKLTEI TRANSMISSION ERROR ON INPUT DEVICE dev 

A transmission error has occurred while reading data from the 
specified device. (MAKLIB) 

7MKLTMN TOO MANY FILENAMES OR PROGRAM NAMES 

More than 40 program names or filenames were specified in the 
command string. The user should separate the job into several 
segments. (MAKLIB) 

PMKLUMT UNEQUAL AMOUNT OF MASTER AND TRANSACTION PROGRAMS 

On a replace request, the number of master programs (or files) 
does not equal the number of transaction program (or files) . 
(MAKLIB) 

MONITOR MUST BE 5.03 or later 

This version of UMOUNT must be run on a 5.03 or later monitor. 
(FILE, MOUNT, DISMOUNT) 
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?MORE THAN ONE OUTPUT FILE ILLEGAL 

Only one output queue-name may be specified in the QUEUE command 
string. (QUEUE) 

?device MOUNTED 

The device is mounted and ready for use. The MOUNT command has 
completed. If a file structure was mounted, a list of the unit 
ID's and the drives on which they are mounted is output. (MOUNT) 

?MOUNT INCOMPLETE 

UMOUNT was unable to complete the user's MOUNT request. Other 
messages give the reasons. (MOUNT) 

7MOUNT UNSUCCESSFUL 

UMOUNT was unable to process the MOUNT request. Other messages 
accompany this one to give the reasons. (MOUNT) 

7MUST BE IN OWNER'S PROJECT TO REQUEST SINGLE ACCESS 

You may not request single-access (/SINGLE switch) unless you 
have the same project number as the owner of the file structure. 
This requirement is enforced since a user with single access may 
execute super-USETI/USETO UUOs. (MOUNT) 

7MUST BE LOGGED IN 

You must be logged in to queue MOUNT, DISMOUNT, and FILE 
requests. (Note that with a change to the monitor, these 
commands may be used with the check or HELP functions without you 
being logged in.) (MOUNT) 

NAME: 

The ACCT.SYS entry for this project-programmer number requires 
you to type a name which matches the one in ACCT.SYS in order to 
login. (LOGIN) 

7NEED 5.03 OR LATER FOR REATTACH COMMAND 

The REATTA program depends on UUOs available in the 5.03 release 
of the monitor. The user attempted to run the program using an 
older monitor. (REATTA) 

7NESTING TOO DEEP 

The @ construction exceeds a depth of nine and may be due to a 
loop a @ command files (COMPIL) . 
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7NETUNN " UNDEFINED NETWORK NODE 

A node/station has been specified that is not in contact with the 
command decoder. 

NO COMMANDS IN QUEUE 

There are no requests (of the specified type; MOUNT, DISMOUNT, 
or FILE) in the queue from any of the users. This message may be 
issued in response to any one of the following commands: MOUNT 
/CHECK, DISMOUNT /CHECK, or FILE C. (FILE, MOUNT, DISMOUNT) 

?NO CORE ASSIGNED 

No core was allocated when the GET command was given and no core 
argument was specified in the GET. 

%N0 DEVICE FOR DIRECTORY 

A FILE command has been issued and you have no device in your 
active search list that is eligible to have the directory written 
on it. That is, the search list does not contain a structure 
that has both a UFD for you and a status of /CREATE and /WRITE. 
The command is processed but no directory is created. (When 
UMOUNT writes directories, it attempts to put them on the first 
structure in your search list that has both a UFD and a status of 
/CREATE and /WRITE.) (FILE) 

NO DIFFERENCES ENCOUNTERED 

No differences were found between the two input files. (FILCOM) 

?(1) NO DIRECTORY FOR PROJECT-PROGRAMMER NUMBER - file.ext 

A UFD does not exist for the requested project-programmer number. 
(COMPIL) 

?NO END BLOCK ENCOUNTERED 

The last block of the bootstrap loader program must be an end 
block (refer to the MACRO manual). (DTCOPY program) 

?NO ENTRY IN AUXACC.SYS 

NO SEARCH LIST OR UFDS CREATED 

If you have no entry in AUXACC.SYS, LOGIN does not create UFDS or 
a search list. You are logged-in and have UFDs if they existed 
previously. You may write only on file structures that have UFDs 
or read all file structures. You may also create a file 
structure search list with SETSRC. You can create UFDs on those 
file structures for which you have an entry in QUOTA. SYS by using 
the MOUNT command. (LOGIN) 
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NO ENTRY IN QUOTA. SYS OR AUXACC.SYS 

You do not have a UFD on the specified structure. Your ability 
to access and create files on the structure depends on the 
individual protection of the structure's other UFDs and files. 
(MOUNT) 

%NO INFO ON name 

You specified a feature that has no available documentation. 
(HELP) 

?NO MODIFIER ALLOWED IN SWITCH switch 

The switch specified cannot have an argument. (QUEUE) 

NONE PENDING FOR YOUR JOB 

You have specified the WAIT or CHECK option in your FILE, MOUNT, 
or DISMOUNT command and there are no pending requests in the 
queue. (FILE, MOUNT, DISMOUNT) 

7NON-EXI STENT DRIVE DPAm 

The user has specified a drive that does not exist in the system. 
(MOUNT) 

%NON-EXISTENT FILE input specification 

The file specified for input could not be found. This message is 
not output if the /NEW switch is specified for the file. (QUEUE) 

7NON-EX MEM AT USER adr 

Usually due to an error in the monitor. 

?NO OPR.JOB FOR THIS REQUEST 

An operator request has been issued, but there is no OMOUNT 
running and enabled to service the request. The request is still 
queued unless the /PAUSE switch was given. 

?NO PRIVILEGES TO SET CPU 

You do not have the privilege set by LOGIN from ACCT.SYS to 
change the CPU specification. You should request that these 
privilege bits be set by the system manager. 

?NO PRIVS TO SET PRIORITY THAT HIGH 

You do not have privileges to set such a high priority. 
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?MO PRIVS TO UNSPOOL 

You do not have privileges to unspool devices, and the operator 
has not set bit 28 in the STATES word. 

?dev:file.ext < NO PROGRAM NAME SPECIFIED > 

The switch (/D or /R) used in the command string requires that a 
program name be given. (MAKLIB) 

?NO REMOTE USERS. TRY AGAIN LATER 

The operator has used the SET SCHEDULE command to prevent LOGINS 
from remote terminals. The message of the day is still typed. 
(LOGIN) 

NO ROOM IN QUEUE, TRY AGAIN LATER 

There is no room in the queue for your request to be sent to the 
operator. (MOUNT) 

?NO ROOM IN QUEUE, TRY AGAIN LATER 

The [3,3] command area (where your requests are stored) is full. 
(FILE, MOUNT, DISMOUNT) 

?(14) NO ROOM OR QUOTA EXCEEDED - file.ext 

There is no room on the file structure or your quota on the file 
structure has been exceeded. 

%NO RUNNING CPUS IN SPECIFICATION 

If none of the CPUs in the job's CPU specification are running, 
the user receives this message every minute until the CPU is 
started or he types a new SET CPU command. 

?NO START ADR 

Starting address or reenter address is zero, because the user 
failed to specify the starting address in the END statement of 
the source program or in the START command. However, an implicit 
starting address of may be specified. 

?NO STRUCTURE NAME 

You did not specify a device in your DISMOUNT command. 
(DISMOUNT) 

?NO SUCH DEVICE 

The device name does not exist or was not assigned to this job. 
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?NO SUCH JOB 



An attempt was made to attach to a job that has not been 
initialized. 



?NO SUCH STR 

A nonexistent file structure was specified. (KJOB) 

?NO SUCH TTY 

The terminal number is not part of the system configuration. 

?NO SUCH UNIT 

The unit does not exist or all units of this type are in use. 



?N0 SYS 



This is a system error and therefore is not a direct fault of the 
user. It is typed for potential diagnostic use. (FILE, MOUNT, 
DISMOUNT) 



?NOT A JOB 

The job number is not assigned to any currently running job. 
(ATTACH, DSK, JCONT) . There is no job logged in at this 
terminal. (CONTINUE) 

?NOT A SAVE FILE 

The file is not a core image file. 

?NOT A SPOOLING DEVICE 

The device specified is not one of the spooling devices (LPT, 
CDP, CDR, PTP, PLT). 

?NOT A STR - TRY AGAIN 

The file structure specified is not recognized by the monitor. 

?NOT A TTY 

The device name given is not a terminal. (REATTA) 

?NOT AVAILABLE 

The operator has restricted use of the specified feature, or the 
console switches are set to disallow the use of a programmable 
address break. 
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Pdrive NOT AVAILABLE 

The drive indicated by you is not currently available. (MOUNT) 

?command NOT CODED 

A command that is not in this version of DUMP was specified in 
the command string. (DUMP) 

?NOT ENOUGH ARGUMENTS 

An insufficient number of files of one type has been specified. 
(MAKLIB) 

?NOT ENOUGH CORE 

The system cannot supply enough core to use as buffers or to read 
in a system program. (COMPIL) 

NOT ENOUGH DRIVES AVAILABLE 

There are currently not enough drives of the right type to mount 
the file structure. (MOUNT) 

NOT ENOUGH TABLE SPACE FOR SWAPPING UNITS 

There are more swapping units than DAEMON allowed for. DAEMON 
should be reassembled. (DAEMON) 

?dev file.ext program NOT FOUND 

The file or the program was not found on the device or in the 
file specified. If a program name is printed, this message may 
indicate that the program names in the command string appear in a 
sequence different from their sequence within the file. 
Therefore, the program may actually exist but missed because of 
the incorrect sequence in the command string. (MAKLIB) 

?file.SAV NOT FOUND 

The program file requested cannot be found on the system device 
or the specified device. 

unit-id NOT MOUNTED 

The file structure is mounted but the specified unit is not. 
According to STRLST.SYS, the unit should belong to the structure. 
Consult the system administrator. This message is followed by 
the message "REQUEST QUEUED TO READY DRIVES." (MOUNT) 

drive NOT READY 

The indicated drive is either off-line or physically write-locked 
when wr ite-enabled was requested. The operator will be notified. 
(MOUNT) 
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unit-id NOT READY 

The requested file structure exists but the unit is not ready. 
This message is followed by the message "REQUEST QUEUED TO READY 
DRIVES." (MOUNT) 

?NOT YET SUPPORTED COMMAND CODE switch 

A switch has been specified that is not implemented. (QUEUE) 

NO UFD CREATED 

You cannot have a UFD on this structure. Your ability to access 
and create files on the structure depends on the individual 
protection of the structure's other UFDs and files. (MOUNT) 

NO UFD CREATED 

You may access the file structure, but you cannot write in your 
disk area since you have no UFD. (MOUNT) 

?NULL DEVICE ILLEGAL 

A colon has been found without a preceding device name. (QUEUE) 

?NXM adr 

While computing the value of an expression, a non-existent 
location was specified when referencing the input file. (DUMP) 

?nK OF CORE NEEDED or ?nP OF CORE NEEDED 

There is insufficient free core to load the files; n is the size 
being requested for the segment that failed (either high or low 
segment, not the sum of the high and low segments) . This message 
occurs when the virtual core for the system has been exceeded or 
the core for this job has been executed. You should type CORE, 
to determine what core has been exceeded, and whether the high or 
low segment was too big. K denotes 1024 words which is the unit 
of core allocation on a KAlO-based system, and P denotes 512 
words (one page) which is the unit of allocation on a KllO-based 
system. 

POFFSET = 1000 TO 777600 (OCTAL) 

The offset specified by the user is not within the acceptable 
range. (DTCOPY program) 

?ONLY BATCH USERS MAY LOGIN. TRY AGAIN LATER 

The operator has used the SET SCHEDULE command to prevent LOGINS, 
except for BATCH jobs. The message of the day is still typed. 
(LOGIN) 
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?OPEN FAILURE ON DATA DEVICE dev 

The OPEN on the specified device failed. (DUMP) 

OPERATOR BUSY, HANG ON PLEASE. 

The user must wait for the operator to become available. 

OPERATOR NOTIFIED 

1. The operator is available and the user may continue typing 
his message. (PLEASE) 

2. A request is queued to the operator to perform a specified 
action. (MOUNT, DISMOUNT) 

OPERATOR NOT ON DUTY 

SCHED 400 is set (i.e., there is no operator on duty to handle 
MOUNT and DISMOUNT requests). If you did not specify the /SHOVE 
switch in your request, then the MOUNT or DISMOUNT cannot be 
completed. If you did specify the /SHOVE switch then you receive 
the message, "SHOVING REQUEST ANYWAY..." and normal processing 
resumes. (FILE, MOUNT, DISMOUNT) 

OPERATOR NOT ON DUTY - /REMOVE IGNORED 

The specified structure will be removed from your search list but 
will not be physically removed from the drive. (DISMOUNT) 

OTHER USER - CANNOT SINGLE ACCESS 

You issued a MOUNT command with the /SINGLE switch specified and 
others have use of the drive. The MOUNT will proceed and the 
/SINGLE switch will be ignored. (MOUNT) 

OTHER USERS SAME PPN 

A program has determined that other jobs are currently logged-in 
under the same project-programmer number. (LOGIN, KJOB) 

POUT OF BOUNDS 

The specified adr is not in your core area, or the high segmenet 
is wr ite-protected and you do not have privileges to the file 
that initialized the high segment. (D,E) 

POUTPUT DEVICE dev CANNOT DO INPUT AT USER adr 

An attempt was made to input from an output device (e.g., the 
line printer) . 

POUTPUT DEVICE ERROR 

An error has occurred on the ouput device. (FILCOM) 
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70UTPUT ERROR 

An I/O error occurred while writing a temporary command file on 
disk. (COMPIL) 

70UTPUT ERROR, STATUS = n 

An I/O error occurred while writing the file on disk; n is the 
disk error code. (DAEMON) 

70UTPUT INITIALIZATION ERROR 

The output device cannot be initialized for one of the following 
reasons: 

1. The device does not exist or is assigned to another job. 

2. The device is not an output device. 

3. The file cannot be placed on the output device. (FILCOM) 

PASSWORD : 

You must type a PASSWORD which matches that in the ACCT.SYS entry 
for this project-programmer number. Echoing is suppressed to 
preserve PASSWORD security. If the user is at a half-duplex 
(local copy) terminal, this message is replaced by a sequence of 
random over-typed characters, over which the user types his 
PASSWORD. (LOGIN) 

PAUSE ("C TO QUIT, CR TO CONT) 

The /PAUSE switch has been specified, and an operator action is 
about to be requested. "C aborts the command before the request 
is queued to the operator. Carriage return-line feed allows the 
command to continue, and the request is queued to the operator. 
(DISMOUNT) 

?PC OUT OF BOUNDS AT USER adr 

An illegal transfer has been made by the user program to user 
location adr. 

7PLEASE KJOB OR DETACH 

Attempt was made to LOGIN a job when you already had a job 
initialized at that terminal. (LOGIN) 

PPLEASE LOGIN AS [OPR] 

The operator is the only person that can initialize DAEMON by 
typing R DAEMON. 
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7PLEASE TYPE ~C FIRST 

A command which would start a job has been issued after a CSTART 
or CCONT. 

?PPN HAS EXPIRED 

The current date is greater than the expiration date of the 
project-programmer number. The user may not login until 
expiration date is changed by the system manager. (LOGIN) 

?PPN OR DEVICE PERMITTED ONLY ON FILE F OR FILE Z CMDS . 

You specified a project-programmer number or a device with an 
implied project-programmer number (e.g., NEW:) in a FILE command 
that does not permit specification of a project-programmer 
number. A project-programmer number may be specified only on the 
FILE F and FILE Z commands. (FILE) 

7PROGRAM ERROR WHILE RESETTING MASTER DEVICE 

FUDGE2 cannot find the master device or cannot find the program 
on the master device. (FUDGE2) 

7PROGRAM NOT PRIVILEGED - IGNORED! 

UMOUNT must be run from SYS: or NEW:, or the user must be [1,2] 
in order for the user to queue requests. (FILE, MOUNT, DISMOUNT) 

7PROJECT 1 MAY NOT BE PTY 

Project 1 is never allowed to login over a pseudo-TTY. (LOGIN) 

PPROTECTION FAILURE f ile-specif ication 

The user does not have privileges to access the indicated file 
(file specification) . (FILE) 

?(2) PROTECTION FAILURE - file.ext 

There was a protection failure or the directory on DECtape had no 
room for the file. (COMPIL) 

?PTR INIT FAILURE 

The logical device PTR is not available or could not otherwise be 
initialized. (DTCOPY program) 

7QUENFI NO FILES IN REQUEST 

An illegal queue request was made; the monitor aborted the 
request. 
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QUOTA. SYS LOOKUP FAILURE 

The LOOKUP to read QUOTA. SYS failed. (MOUNT) 

QUOTA. SYS NOT ON STRUCTURE 

QUOTA. SYS is not part of this structure. The user may still use 
the file structure, but no UFD will be created. (MOUNT) 

QUOTA. SYS READ ERROR 

An I/O error occurred while reading QUOTA. SYS. (MOUNT) 

QUOTA. SYS OR AUXACC.SYS READ ERROR 

An I/O error occurred while QUOTA. SYS or AUXACC.SYS was being 
read. For MOUNT commands this means that no UFD can be created. 
(MOUNT) 

QUOTA. SYS WRONG FORMAT VERSION 

Wrong version of QUOTA. SYS is on the file structure being 
mounted. Consult the operator. (MOUNT) 

%REASSIGN ILLEGAL FOR RESTRICTED DEVICE - /RELEASE ASSUMED 

The user may not reassign a restricted device. If he attempts to 
do so, the device is released from his job and returned to the 
pool of restricted devices. (DISMOUNT) 

%REASSIGN JOB # NOT ASSIGNED - /RELEASE ASSUMED 

The user attemped to reassign a device to a job that doesn't 
exist. The device is released from his job. (DISMOUNT) 

7/REELID REQUIRES MAGTAPE 

The user specified a /REELID switch but the device he requested 
to be mounted is not a magnetic tape. The /REELID switch may be 
specified only when mounting magnetic tapes. (MOUNT) 

?file structure name RENAME FAILURE n 

The RENAME to change the protection of the file failed; n is the 
disk error code. (KJOB, LOGOUT) 

?(4) RENAME FILENAME ALREADY EXISTS - file.ext 

The new filename on a RENAME command already exists. (COMPIL) 

REQUEST QUEUED 

Your request to perform a specified action has been queued to the 
operator. (FILE, DISMOUNT, and MOUNT for non-file structures). 
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REQUEST QUEUED TO MOUNT UNITS 

A request is queued to the operator to mount and ready the packs 
on the proper drives. (MOUNT) 

REQUEST QUEUED TO READY DRIVES 

The requested structure is mounted but one or more drives (as 
specified by previous messages) are not ready. A request is 
queued to the operator. (MOUNT) 

PREQUIRES DEVICE NAME 

The device name or file structure name is required with the MOUNT 
and DISMOUNT commands. 

7REQUIRES "/REELID" SWITCH 

You must include the /REELID switch and its argument in the 
command string when you want to have a magnetic tape mounted. 
(MOUNT for magnetic tapes) 

PREQUIRES /VID SWITCH 

You must include the /VID switch and its argument in your MOUNT 
command for DECtapes and for all input-only devices. (MOUNT for 
DECtapes and all input-only devices.) 

%RESPONSE MUST BE SINGLE LETTER WITH OPTIONAL STR LIST 

You have not followed the correct format for a response to 
CONFIRM: . Responses are limited to a single letter or a single 
switch, optionally followed by a space or tab and a list of file 
structures. A new response will be requested. (KJOB) 

7RIGHT BRACKET REQUIRED IN DIRECTORY 

The project-programmer number must be enclosed in square 
brackets. (QUEUE) 

PSCNDFN DOUBLE FILE NAME ILLEGAL 

A double file name has been specified (sometimes through use of 
*). 

7SCNNSF NULL SFD ILLEGAL 

A null SFD has been specified in the command string, and its use 
is illegal. 

PSCNSVR SWITCH VALUE REQUIRED ON SINCE 

A /SINCE was specified with no argument. 
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7SCNUDN UNRECOGNIZED NAME IN DATE/TIME 

An illegal character appears after a time/date - type switch, 
(e.g., /SINCE :L-APR-L971.) 

7SCNUKS UNKNOWN SWITCH switch 

An unknown switch has been specified in the command string. 

%SEARCH LIST DOES NOT ALLOW CREATES 

There are no file structures available to the user on which he 
can write. Run MOUNT or SETSRC to modify the search list as 
necessary. (LOGIN) 

%SEARCH LIST IS EMPTY 

There are no file structures in the DSK: search list that are 
available to the user. He can run the SETSRC program to modify 
his search list. (LOGIN) 

SHOVING REQUEST ANYWAY... 

SCHED 400 is set {i.e., there is no operator on duty to handle 
MOUNT and DISMOUNT requests). However, the user has specified 
the /SHOVE switch so the request will be queued even though there 
may be no one at the computer to MOUNT or DISMOUNT the device (s). 
(FILE, MOUNT, DISMOUNT) 

7SINGLE ACCESS BY JOB n 

You requested to have a structure mounted that is already mounted 
by job n with the /SINGLE switch specified. (FILE, MOUNT) 

file.ext SOFTWARE CHECKSUM OR REDUNDANCY ERROR 

The file has no error as flagged in the UFD of the file 
structure. (LOGIN) 

?SOME OTHER TIME 

You are not scheduled to LOGIN at this time. You should try 
again when you are allowed to login. (LOGIN) 

PSORRY, CAN'T OPEN DSK, PLEASE CALL THE OPERATOR 

This message is returned from the GRIPE program. 

PSORRY, CAN'T WRITE IN COMPLAINT AREA, PLEASE CALL THE OPERATOR 
This message is returned from the GRIPE program. 
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7SORRY, COMPLAINT BASKET IS FULL, PLEASE CALL THE OPERATOR 
This message is returned from the GRIPE program. 

7SORRY, NO UFD FOR COMPLAINT BASKET, PLEASE CALL THE OPERATOR 
This message is returned from the GRIPE program. 

%SPECIFIED LOGICAL NAME WAS IN USE 

You specified a logical name in your MOUNT command that was 
already in use by the same job. The device with which the 
logical name was previously associated is no longer associated 
with the logical name. The logical name is now associated with 
the newly mounted device. (MOUNT) 

7STATION NUMBER INVALID 

The requested station number is not recognized by the system. 
(LOCATE) 

STR HAS ONLY n UNITS 

You have requested more drives than are necessary to accommodate 
the structure. The MOUNT proceeds with only the number of drives 
necessary. (MOUNT) 

STRUCTURE ALREADY MOUNTED 

[MOUNT COUNT = n] 

The requested file structure already exists and does not need to 
be physically mounted. "n" is the number of users (not including 
this one) who currently have the structure mounted. (MOUNT) 

7STRUCTURE NOT MOUNTED 

You requested that a structure be dismounted. The specified 
structure either is not a valid name or it is not mounted. 
(DISMOUNT) 

?STRUUO FAILURE 

The STRUUO UUO gave an error return. Notify the operator. 
(KJOB, LOGOUT) 

%SUPERSEDING EXISTING FILE 

A warning message indicating that a file already exists with the 
specified name. This file is being superseded. (TECO) 

%SWAP READ ERROR UNIT abc STATUS = n 

An I/O error occurred while reading the swapping space. The data 
is written into the DAEMON file as read. (DCORE) 
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?SWITCH ERROR 

An illegal switch specification was given. (COPY program) 

?switch SWITCH ILLEGAL 

The switch specified cannot be used with the given queue name. 
(QUEUE) 

7SWITCH VALUE TOO LARGE x 

The value given to the switch exceeds the maximum value. (QUEUE) 

7SYNTAX ERROR 

There is a syntax error in the command string. Check for 
incorrect parentheses or two operators in a row. 

7SYSSTR FAILURE 

The SYSSTR UUO gave an error return. Notify the operator. 
(KJOB, LOGOUT) 

PSYSTEM ERROR - xxxxxx 

System errors designate operator or system errors and are not a 
direct fault of the user. They are typed for possible diagnostic 
use. 

SYSTEM ERROR AT LOC nnn 

This is a system error and therefore is not a direct fault of the 
user. It is typed for potential diagnostic use. (FILE, MOUNT, 
DISMOUNT) 

?file structure name SYSTEM ERROR - DSKCHK UUO FAILED 

This is a system error and therefore is not a direct fault of the 
user. It is typed for potential diagnostic use. (MOUNT, 
DISMOUNT) 

?file-structure name SYSTEM ERROR - JOBSTR UUO FAILED 

This is a system error and therefore is not a direct fault of the 
user. It is typed for potential diagnostic use. (MOUNT, 
DISMOUNT) 

7SYSTEM ERROR - SYSPHY UUO FAILED 

This is a system error and therefore is not a direct fault of the 
user. It is typed for potential diagnostic use. (FILE, MOUNT, 
DISMOUNT) 
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7SYSTEM ERROR - WRONG FORMAT VERSION NUMBER IN STRLST.SYS 

STRLST.SYS is not in a format that is understood by MOUNT. This 

is a system error and therefore is not a direct fault of the 

user. It is typed for potential diagnostic use. (FILE, MOUNT, 
DISMOUNT) 

7SYSTEM I/O ERROR AT loc STATUS = code 

An unexpected I/O error occurred at location "loc". "code" is 
the status code returned by the GETSTS UUO. This is a system 
error and therefore is not a direct fault of the user. It is 
typed for potential diagnostic use. Consult the system 
administrator. (FILE, MOUNT, DISMOUNT) 

7SYSTEM NOT AVAILABLE 

The operator has used the SET SCHED command to prevent LOGINs 
from timesharing terminals. The message of the day is still 
typed. (LOGIN) 

7TABLE OVERFLOW - CORE UUO FAILED TRYING TO EXPAND TO xxx 

The GLOB program requested additional core from the monitor, but 
none was available. (GLOB) 

7THIS MONITOR WAS BUILT FOR A xxx AND WILL NOT RUN PROPERLY ON A yyy 

The monitor is not running on the machine for which it was built. 
xxx and yyy are PDP-6, KA10, or KI10. 

7TIME LIMIT EXCEEDED 

The time limit allocated for the job has been reached. The job 
is stopped and the terminal is returned to monitor mode. 

TIMESHARING WILL CEASE IN m HOURS n MINUTES 

The KSYS command (OPSER) or SET KSYS UUO has been issued in order 
to stop timesharing on the system at the indicated time. 

?TOO FEW ARGUMENTS 

A command has been typed, but necessary arguments are missing. 

?TOO MANY FILENAMES OR PROGRAM NAMES 

More than 40 program names or filenames were specified in the 
command string. The user should separate the job into several 
segments. (MAKLIB) 
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?TOO MANY FILES, LAST PROCEED IS file.ext 

The user requested (either explicitly or implicitly) more than 22 
files to be filed onto or recalled from DECtape. The request is 
processed up to the point where "file.ext" is transferred. 
(FILE) 

?TOO MANY FILE STRUCTURES 

The number of file structures exceeds the capacity of the monitor 
data base. The current limit is 14 (decimal). (ONCE ONLY) 

?T00 MANY NAMES or ?TOO MANY SWITCHES 

Command string complexity exceeds table space in the COMPIL 
program. (COMPIL) 

7UNKNOWN COMMAND 

The monitor passed a command to COMPIL which COMPIL does not 
recognize. (COMPIL) 

7UNKNOWN DEFAULT FOR SWITCH switch 

The default condition is not known for the specified switch. 
(DUMP, QUEUE) 

PUNKNOWN DEVICE OR STRUCTURE NAME 

The device or file structure name does not exist in the system 
administrator's file SYS:STRLST.SYS and, therefore, is not 
defined for the system. The operator or administrator may be 
requested to define the file structure by adding it to STRLST.SYS 
with the REACT program. (MOUNT) 

7UNKN0WN SWITCH switch 

The switch named has been mistyped. (DUMP, QUEUE) 

PUNKNOWN SWITCH VALUE n 

The argument specified with the switch has been mistyped. (DUMP, 
QUEUE) 

PUNRECOGNIZABLE SWITCH 

An ambiguous or undefined word followed a slash. (COMPIL) 

?UUO AT USER adr 

This message accompanies many error messages and indicates the 
location of the UUO that was the last instruction the user 
program executed before the error occurred. 
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n VERIFICATION ERRORS 

On a word by word comparison requested via the /V switch, n 
discrepancies have been detected between the input DECtape and 
output DECtape. (DTCOPY program) 

WAITING... 2 C's TO EXIT 

A request has been queued to the operator and the command is 
waiting for the operator to complete the request. If you do not 
want to wait for completion of the operator's action, you can 
type two CTRL/Cs without aborting the command. The operator 
action will still be completed. Later a DISMOUNT/CHECK or 
MOUNT/CHECK can be given to check for completion. (Note that 
this message is not issued when the /NOWAIT switch is 
specified.) (MOUNT, DISMOUNT) 



WAIT PLS 

The system's primary accounting file FACT. SYS was busy. It is 

retried for ten seconds before FACT.X01 is tried. This message 

can appear if many users are logging in simultaneously. (LOGIN, 
KJOB, LOGOUT) 

%WARNING - INPUT REQUEST USES ONLY TWO ENTRIES 

Only two files can be specified in the input queue request, the 
control file and the log file. (QUEUE) 

1WARNING NO INDEX ON OUTPUT FILE-CONTINUING 

You have changed the structure of the index library file when 
deleting, appending, or inserting, thereby invalidating the 
index. The index has been removed from the new file. Reindexing 
is required. (MAKLIB) 

?dev WASN'T ASSIGNED 

The device is not currently assigned to your job and cannot be 
deassigned or reassigned by the job. 

PWASN'T DET 

The specified device is not detached. 

NAME 
7WILDCARD ILLEGAL IN INPUT QUEUE FILE DIRECTORY 

EXTENSION 

The wildcard construction cannot be used when specifying the 
Batch input queue. (QUEUE) 

NAME 
7WILDCARD ILLEGAL IN OUTPUT DIRECTORY 

EXTENSION 

The wildcard construction cannot be used in the output queue 
specification. (QUEUE) 
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%WLDNSF NO SUCH FILES AS file spec 

A file has been specified which does not exist in the user's 
default directory. 

?WRITE LOCK ERROR 

An attempt was made to write on a write-locked DECtape. (DTCOPY 
program) 

7WRONG FORMAT FOR SYMBOL 

A symbol was given in the format program : symbol and a symbol 
name did not follow the colon; in other words, the colon must be 
followed by a symbol. (DUMP) 

PWRONG FORMAT VERSION NUMBER IN SYSTEM FILES 

Wrong version of ACCT.SYS or AUXACC.SYS is on the system. 
Consult the operator so that he can REACT to change the 
accounting files. (LOGIN) 

drive WRONG UNIT TYPE 

The user has requested a drive which is inappropriate for the 
pack to be mounted. (For example, an RP03 pack cannot be mounted 
on an RP04 drive.) (MOUNT) 

YOU ARE LOGGED IN AS n,m 

When you log in with a unique programmer number (project, #) , 
this message informs you of the project-programmer number that 
LOGIN assigned. (LOGIN) 

DAEMON 
?YOU DON'T HAVE PRIVILEGES TO WRITE FILE 

CCL 

You attempted to write in a file to which you did not have 
access. (DAEMON) 

?l+lnK CORE 
VIR.CORE LEFT = 

The swapping space or the core allocated to timesharing is all in 
use (i.e., there is no available virtual core). The user should 
wait a few minutes, and then attempt to login again. If this 
message still appears, it should be reported to the operator. 

m+n/p CORE 
VIR.CORE LEFT = v 

Key: m = number of blocks in low segment. 

n = number of blocks in high segment. 
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p = maximum core per job. (Maximum physical user core 
unless limited by operator, or there are jobs locked in 
core (refer to DECsystem-10 Monitor Calls.)) 

v = number of K blocks unassigned in core and on the 
swapping device. 

Note that nK represents 1024-word blocks which is the unit of 
core allocation on a KAlO-based system, and nP represents 
512-word blocks which is the unit of allocation on a KllO-based 
system. 
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A.l FILENAME EXTENSIONS 

Table A-l lists the filename extensions that have specific meanings in 
the DECsystem-10. 



Table A-l 
Filename Extensions 



Filename 


Type of File 


Meaning 


Extension 






ABS 


Object 


Absolute (nonrelocatable) program 


AID 


Source 


Source file in AID language 


ALG 


Source 


Source file in ALGOL language 


ALP 


ASCII 


Printer forms alignment 


ATO 


ASCII 


OPSER automatic command file 


AWT 


Binary 


Data for automatic wire tester 


BIO 


Source 


Source file in BLIS10 


Bll 


Source 


Source file in BLISS-11 


BAC 


Object 


Reserved for output from the BASIC 
Compiler 


BAK 


Source 


Backup file from TECO or LINED 


BAS 


Source 


Source file in BASIC language 


BCM 


ASCII 


Listing file created by FILCOM 
(binary compare) 


BCP 


Source 


Source file in BCPL language 


BIN 


Binary 


Binary file 


BLB 


ASCII 


Blurb file 


BLI 


Source 


Source file in BLISS language 


BUG 


Object 


Saved to show a program error 


BWR 


ASCII 


Beware file listing warnings about a 
file or program 


CAL 


Object 


CAL data and program files 


CBL 


Source 


Source file in COBOL language 


CCL 


ASCII 


Alternate convention for command 
file (@ command file construction 
for programs other than COMPIL) 


CCO 


ASCII 


Listing of modifications to 
nonresident software 


CDP 


ASCII, Binary 


Spooled output for card punch 


CFC 


ASCII 


Compressed file compare. Group of 
.SCM files combined with PIP. 


CKP 


Binary 


Checkpoint core image file created 
by COBOL operating system 


CHN 


Object 


CHAIN file 
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Table A-l (Cont. ) 
Filename Extensions 



Filename 


Type of File 


Meaning 


Extension 






CMD 


ASCII 


Command file for indirect commands 
(@ construction for COMPIL) 


CMP 


ASCII 


Complaint file by GRIPE 


COR 


ASCII 


Correction file for SOUP 


CRF 


ASCII 


CREF (cross-reference) input file 


CTL 


ASCII 


MP"B control file 


DAE 


Binary 


Default output for DAEMON-taken core 
dumps 


DAT 


ASCII, Binary 


Data (FORTRAN) file 


DDT 


ASCII 


Input file to FILDDT 


DCT 


ASCII 


Dictionary of words 


DIR 


ASCII 


Directory from FILE command or 
DIRECT program 


DMP 


ASCII 


COBOL compiler dump file 


DOC 


ASCII 


Listing of modifications to the most 
recent version of the software 


DRW 


Binary 


Drawing for VBlOC drawing system 


DSE 


ASCII 


Directory sorted by extension 


DSF 


ASCII 


Directory sorted by filename 


ERR 


ASCII 


Error message file 


EXE 


Object 


Executable program 


F4 


Source 


Source file in F40 (FORTRAN) 
language 


FAI 


Source 


Source file in FAIL language 


FCL 


Source 


Source file in FOCAL language 


FFS 


ASCII 


Fast FORTRAN stream 


FLO 


ASCII 


English language flowchart 


FOR 


Source 


Source file in FORTRAN-10 language 


FRM 


ASCII 


Blank form for handwritten records 


FTP 


Source 


FORTRAN test programs 


FUD 


ASCII 


FUDGE2 listing output 


GND 


ASCII 


List of ground pins for automatic 
wiretap 


HGH 


Object 


Nonsharable high segment of a 
two-segment program (created by SAVE 
command) 


HLP 


ASCII 


Help files containing switch 
explanations, etc. 


IDA 


ASCII, Binary 


COBOL ISAM data file 


IDX 


ASCII, SIXBIT 


Index file of a COBOL ISAM file 


INI 


ASCII, Binary 


Initialization file 


LAP 


ASCII 


Output from the LISP compiler 


LIB 


ASCII 


COBOL source library 


LOG 


ASCII 


MPB or LINK-10 log file 


LOW 


Object 


Low segment of a two-segment program 
(created by SAVE command) 


LPT 


ASCII 


Spooled output for line printer 


LSD 


ASCII 


Default output for DUMP program 


LSP 


Source 


Source file in LISP language 


LSQ 


ASCII 


Queue listing created by QUEUE 
program 


LST 


ASCII 


Listing data created by assemblers 
and compilers 


MAC 


Source 


Source file in MACRO language 


MAN 


ASCII 


Manual (documentation) file 


MAP 


ASCII 


Loader or LINK-10 map file 
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Table A-l (Cont. ) 
Filename Extensions 



Filename 


Type of File 


Meaning 


Extension 






MEM 


ASCII 


Memorandum file typically output 
from RUNOFF 


MID 


Source 


Source file in MIDAS (MIT Assembler) 
language 


MIM 


Binary 


Snapshot of MIMIC simulator 


MSB 


Object 


Music compiler binary output 


MUS 


Source 


Music compiler input 


N 


Source 


Source file in NELIAC language 


NEW 


All 


New version of a program or file 


OBJ 


Object 


PDP-11 relocatable binary file 


OLD 


Source, Object 


Backup source program 


OPR 


ASCII 


Installation and assembly 
instructions 


OVR 


Object 


COBOL overlay file 


Pll 


Source 


Source program in MACYll language 


PAK 


ASCII 


Files compressed by PACK. TEC to save 
disk space 


PAL 


Source 


Source file in PAL10 (PDP-8 
assembler) 


PL1 


Source 


Source file in PL1 language 


PLM 


ASCII 


Program Logic Manual 


PLO 


Binary 


Compressed plot output 


PLT 


ASCII 


Spooled output for plotter 


PPL 


Source 


Source file in PPL language 


PTP 


ASCII, Binary 


Spooled output for paper-tape punch 


Qxx 


ASCII 


Edit backup file, like .BAK (all xx) 


QUD 


ASCII, Binary 


Queued data file 


QUE 


Binary 


Queue request file 


QUF 


Binary 


Master queue and request file 


REL 


Object 


Relocatable binary file 


RIM 


Object 


RIM loader file 


RMT 


Object 


Read-in mode (RIM) format file (PIP) 


RNB 


ASCII 


RUNOFF input for producting a .BLB 
file 


RNC 


ASCII 


RUNOFF input for producing a .CCO 
file 


RND 


ASCII 


RUNOFF input for producing a .DOC 
file 


RNE 


ASCII 


RUNOFF input for error message text 


RNH 


ASCII 


RUNOFF input for producing a .HLP 
file 


RNL 


ASCII 


RUNOFF input for program logic 
manual 


RNM 


ASCII 


RUNOFF input for producing a .MAN 
file 


RNO 


ASCII 


Programming specifications in RUNOFF 
input 


RNP 


ASCII 


RUNOFF input for producing a .OPR 
file 


RNS 


ASCII 


RUNOFF input for text file of 
standards 


RSP 


ASCII 


Script response time log file 


RSX 


All 


Files for RSX-11D 


RTB 


Object 


Read-in mode (RIMlOB) format file 
(PIP) 


SAI 


Source 


Source file in SAIL language 

___— 
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Filename 


Type of File 


Meaning 


Extension 






SAV 


Object 


Low segment from a one-segment 
program (created by SAVE command) 


SCD 


ASCII 


Differences in directory 


SCM 


ASCII 


Listing file created by FILCOM 
(source compare) 


SCP 


ASCII 


SCRIPT control file 


SEQ 


ASCII, SIXBIT 


Sequential COBOL data file, input to 
ISAM program 


SFD 


Binary 


Subfile directory (reserved usage) 


SHR 


Object 


Sharable high segment file of a 
two-segment program (created by 
SSAVE command) 


SMP 


Source 


Source file in SIMPLE language 


SNO 


Source 


Source file in SNOBOL language 


SNP 


ASCII 


Snapshot of disk by DSKLST 


SPC 


ASCII 


Corrected file for SPELL program 


SPD 


ASCII 


Dictionary for SPELL program 


SPM 


ASCII 


File of misspelled words for SPELL 
program 


SPU 


ASCII 


File of upper case words for SPELL 
program 


SPX 


ASCII 


File of exception (error) lines for 
SPELL program 


SRC 


ASCII 


Source files 


STD 


ASCII 


Standards 


SVE 


Object 


.SAVed file from a single user 
monitor 


SYM 


Binary 


LINK-10 symbol file 


SYS 


Binary 


Special system files 


TEC 


ASCII 


TECO macro 


TEM 


ASCII, Binary 


Temporary files 


TMP 


ASCII, Binary 


Temporary files 


TPB 


ASCII 


Typeset input for producing a .BLB 
file 


TPC 


ASCII 


Typeset input for producing a .CCO 
file 


TPD 


ASCII 


Typeset input for producing a .DOC 
file 


TPE 


ASCII 


Typeset input for producing error 
message text 


TPH 


ASCII 


Typeset input for producing a .HLP 
file 


TPL 


ASCII 


Typeset input for producing a logic 
manual 


TMP 


ASCII 


Typeset for producing a .MAN file 


TPO 


ASCII 


Typeset input for producing a 
programming specification 


TPP 


ASCII 


Typeset input for producing an .OPR 
file 


TST 


All 


Test data 


TXT 


ASCII 


Text file 


UFD 


Binary 


User file directory (reserved usage) 


UPD 


ASCII 


Updates flagged in margin (FILCOM) 
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Filename Extensions 



Filename 


Type of File 


Meaning 


Extension 






VMX 


Object 


Expanded save file starting at a 
location greater than zero and used 
as a special support program for 
virtual memory 


WCH 


ASCII 


SCRIPT monitor (WATCH) file 


WRL 


ASCII 


Wirelist 


XOR 


Binary 


Module data for XOR tester 


XPN 


Object 


Expanded save file (FILEX and 
LINK-10) 


Zxx 


ASCII 


Edit original file (all xx) 



A. 2 RESERVED PROJECT-PROGRAMMER NUMBERS 

Table A-2 itemizes the project-programmer numbers that are allocated 
for specific functions in the DECsystem-10 . 



Table A-2 
Project-Programmer Numbers 



Number 


Meaning 


1,1 


Master File Directory (MFD) 


1,2 


Operator functions 


1,3 


Old or superseded versions of system programs 




(device OLD: ) 


1,4 


System library (device SYS:) 


1,5 


New or experimental versions of system programs 




(device NEW: ) 


1,6 


User maintained library (device PUB:) 


2,* 


Recommended for operator's use 


2,5 


Storage for help text files (*.HLP) (device HLP:) 


3,3 


System and Multiprogram Batch (MPB) queues 


4,* 


Test and performance analysis systems 


4,4 


FAILSAFE testing 


4,5 


FAILSAFE testing 


5,* 


Libraries 


5,1 


BASIC source library (device BAS:) 


5,2 


COBOL source library for COPY verb (device COB:) 


5,3 


PDP-11 source library (device MXI:) 


5,4 


ALGOL source library (device ALG:) 


5,5 


BLISS source library (device BLI:) 


5,6 


FORTRAN source library (device FOR:) 


5,7 


MACRO source library (device MAC:) 


5.10 


Text editor library (device TED:) 


5,11 


Rel file library (device REL:) 


5,12 


RUNOFF library (device RNO:) 


5,13 


SNOBOL library (device SNO:) 


5,14 


Doc file library (device DOC:) 


5,15 


FAIL library (device FAI : ) 
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Number 


Meaning 


5,16 


MUSIC library (device MUS:) 




5,17 


MACRO universal files (device UNV:) 




5,20 


NELIAC (device NEL: ) 




5,21 


DUMP (device DMP:) 




5,22 


POP2 (device POP: ) 




5,23 


Test library (device TST: ) 




6,* 


Field service and hardware diagnostics 




7,7 


Software acceptance 




10,1 


Special system programming storage 


region 




containing copies of SYS:CRASH.SAV (device 


XPN:) 


10,6 


Software distribution 




10,7 


Software distribution (device DEC:) 





A. 3 RESERVED DEVICE NAMES 

Table A-3 lists logical device names (ersatz devices) that are 
predefined in the DECsystem-10. 

To avoid confusion, it is recommended that these names not be used for 
private file structures. 



Table A-3 
Device Names 



Name 


i Use 


UFD 


Search List 


ALG 


ALGOL library 


[5,4] 


System 


ALL 




User ' s 


All currently 
mounted structures 


BAS 


: BASIC library 


[5,1] 


System 


BLI 


BLISS library 


[5,5] 


System 


COB 


COBOL library 


[5,2] 


System 


DEC 


DEC supplied 
software 


[10,7] 


System 


DOC 


DOC file library 


[5,14] 


System 


DSK 




User ' s 


Job 


FAI 


FAIL library 


[5,15] 


System 


FOR 


FORTRAN library 


[5,6] 


System 


HLP 


HELP library 


[2,5] 


System 


LIB 


User defined library 


Set by each user 


System 


MAC 


MACRO library 


[5,7] 


System 


MUS 


MUSIC library 


[5,16] 


System 


MXI 


PDP-11 library 


[5,3] 


System 


NEW 


New system library 


[1,5] 


System 


NUL 




None 




OLD" 


Old system library 


[1,3] 


System 


PUB 


User maintained 
library 


[1,6] 


System 


REL 


Rel file library 


[5,11] 


System 


RNO 


RUNOFF library 


[5,12] 


System 
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Name 


i Use 


UFD 


Search 


List 


SNO 


. SNOBOL library 


[5,13] 


System 




STD 


Standard Software 


[1,4] 


System 




SYS 


System library 


[1,4] 


System 




TED- 


Text editor library 


[5,10] 


System 




TST: 


Test library 


[5,23] 


System 




UNV: 


MACRO universal 
library 


[5,17] 


System 




XPN 


Crash library 


[10,1] 


System 
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Table B-l 
ASCII Card Codes 



ASCII 


Octal 


Card 


ASCII 


Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


NULL 


00 


12-0-9-8-1 


@ 


100 


8-4 


CTRL-A 


01 


12-9-1 


A 


101 


12-1 


CTRL-B 


02 


12-9-2 


B 


102 


12-2 


CTRL-C 


03 


12-9-3 


C 


103 


12-3 


CTRL-D 


04 


9-7 


D 


104 


12-4 


CTRL-E 


05 


0-9-8-5 


E 


105 


12-5 


CTRL-F 


06 


0-9-8-6 


F 


106 


12-6 


CTRL-G 


07 


0-9-8-7 


G 


107 


12-7 


CTRL-H 


10 


11-9-6 


H 


110 


12-8 


TAB 


11 


12-9-5 


I 


111 


12-9 


LP 


12 


0-9-5 


J 


112 


11-1 


VT 


13 


12-9-8-3 


K 


113 


11-2 


FF 


14 


12-9-8-4 


L 


114 


11-3 


CR 


15 


12-9-8-5 


M 


115 


11-4 


CTRL-N 


16 


12-9-8-6 


N 


116 


11-5 


CTRL-0 


17 


12-9-8-7 





117 


11-6 


CTRL-P 


20 


12-11-9-8-1 


P 


120 


11-7 


CTRL-Q 


21 


11-9-1 


Q 


121 


11-8 


CTRL-R 


22 


11-9-2 


R 


122 


11-9 


CTRL-S 


23 


11-9-3 


S 


123 


0-2 


CTRL-T 


24 


9-8-4 


T 


124 


0-3 


CTRL-U 


25 


9-8-5 


U 


125 


0-4 


CTRL-V 


26 


9-2 


V 


126 


0-5 


CTRL-W 


27 


0-9-6 


w 


127 


0-6 


CTRL-X 


30 


11-9-8 


X 


130 


0-7 


CTRL-Y 


31 


11-9-8-1 


Y 


131 


0-8 


CTRL-Z 


32 


9-8-7 


Z 


132 


0-9 


ESCAPE 


33 


0-9-7 


[ 


133 


12-8-2 


CTRL-\ 


34 


11-9-8-4 


\ 


134 


0-8-2 


CTRL-] 


35 


11-9-8-5 


] 


135 


11-8-2 


CTRL-" 


36 


11-9-8-6 




136 


11-8-7 


CTRL- 


37 


11-9-8-7 




137 


0-8-5 


SPACE 


40 




i 


140 


8-1 



NOTE 

The ASCII character ESCAPE (octal 33) is 
also CTRL- [ on a terminal. 
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CARD CODES 



Table B-l (Cont. ) 
ASCII Card Codes 



ASCII 


Octal 


Card 


ASCII 


Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


i 


41 


12-8-7 


a 


141 


12-0-1 


i 


42 


8-7 


b 


142 


12-0-2 


# 


43 


8-3 


c 


143 


12-0-3 


? 


44 


11-8-3 


d 


144 


12-0-4 


% 


45 


0-8-4 


e 


145 


12-0-5 


& 


46 


12 


f 


146 


12-0-6 


i 


47 


8-5 


g 


147 


12-0-7 


( 


50 


12-8-5 


h 


150 


12-0-8 


) 


51 


11-8-5 


i 


151 


12-0-9 


* 


52 


11-8-4 


J 


152 


12-11-1 


+ 


53 


12-8-6 


k 


153 


12-11-2 


i 


54 


0-8-3 


1 


154 


12-11-3 


- 


55 


11 


m 


155 


12-11-4 


, 


56 


12-8-3 


n 


156 


12-11-5 


/ 


57 


0-1 


o 


157 


12-11-6 





60 





P 


160 


12-11-7 


1 


61 


1 


q 


161 


12-11-8 


2 


62 


2 


r 


162 


12-11-9 


3 


63 


3 


s 


163 


11-0-2 


4 


64 


4 


t 


164 


11-0-3 


5 


65 


5 


u 


165 


11-0-4 


6 


66 


6 


V 


166 


11-0-5 


7 


67 


7 


w 


167 


11-0-6 


8 


70 


8 


X 


170 


11-0-7 


9 


71 


9 


y 


171 


11-0-8 


: 


72 


8-2 


z 


172 


11-0-9 


i 


73 


1-8-6 


{ 


173 


12-0 


< 


74 


12-8-4 


1 


174 


12-11 


= 


75 


8-6 


1 


175 


11-0 


> 


76 


0-8-6 


~ 


176 


11-0-1 


■? 


77 


0-8-7 


DEL 


177 


12-9-7 



NOTE 

The ASCII characters } and ~ (octal 175 

and 176) are treated by the monitor as 

ALTmode which is often considered to be 
the same as ESCAPE. 
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CARD CODES 



Table B-2 
DEC-026 Card Codes 





Octal 


Card 




Octal 


Card 


Character 


Code 


Punches 


Character 


Code 


Punches 


SPACE 


40 




(3 


100 


8-4 


i 


41 


12-8-7 


A 


101 


12-1 


1 


42 


0-8-5 


B 


102 


12-2 


# 


43 


0-8-6 


C 


103 


12-3 


$ 


44 


11-8-3 


D 


104 


12-4 


% 


45 


0-8-7 


E 


105 


12-5 


& 


46 


11-8-7 


F 


106 


12-6 


i 


47 


8-6 


G 


107 


12-7 


( 


50 


0-8-4 


H 


110 


12-8 


) 


51 


12-8-4 


I 


111 


12-9 


* 


52 


11-8-4 


J 


112 


11-1 


+ 


53 


12 


K 


113 


11-2 


i 


54 


0-8-3 


L 


114 


11-3 




55 


11 


M 


115 


11-4 


. 


56 


12-8-3 


N 


116 


11-5 


/ 


57 


0-1 





117 


11-6 





60 





P 


120 


11-7 


1 


61 


1 


Q 


121 


11-8 


2 


62 


2 


R 


122 


11-9 


3 


63 


3 


S 


123 


0-2 


4 


64 


4 


T 


124 


0-3 


5 


65 


5 


U 


125 


0-4 


6 


66 


6 


V 


126 


0-5 


7 


67 


7 


W 


127 


0-6 


8 


70 


8 


X 


130 


0-7 


9 


71 


9 


Y 


131 


0-8 


: 


72 


11-8-2/11-0 


Z 


132 


0-9 


/ 


73 


0-8-2 


[ 


133 


11-8-5 


< 


74 


12-8-6 


\ 


134 


8-7 


= 


75 


8-3 


] 


135 


12-8-5 


> 


76 


11-8-6 


^ 


136 


8-5 


•? 


77 


12-8-2/12-0 


— 


137 


8-2 



NOTE 

Octal codes 0-37 and 140-177 are the same 
as in ASCII. 
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APPENDIX C 
TEMPORARY FILES 



The temporary files in Table C-l are used by various programs in the 
DECsystem-10 computing system. These files are in the following form: 

nnn xxx.TMP 

where nnn is the user's job number in decimal, with leading zeroes to 
make three digits, and xxx specifies the use of the file. 



Table C-l 
Temporary Files 



Name 


Meaning 


nnn ALG.TMP 

nnn ASl.TMP 
nnn AS2.TMP 
nnn AS3.TMP 
nnn BLl .TMP 

nnn COB. TMP 

nnn CPY.TMP 
nnn CRE.TMP 

nnn DAE. TMP 
nnn DMP.TMP 
nnn EDS. TMP 


Read by ALGOL and contains one line for each 
program to be compiled. It may also contain the 
command NAME! which causes ALGOL to transfer 
control to the named program. 

Written, read, and deleted by COBOL and contains 
input to the COBOL assembler. 

Read by BLISS and contains one line for each 

program to be compiled. 

Read by COBOL and contains one line for each 

program to be compiled. It may also contain the 

command NAME! which causes COBOL to transfer 

control to the named program. 

Written, read, and deleted by COBOL and contains 

copies of source files with library routines 

inserted. 

Read by CREF and contains commands for each file 

which has produced a CREF listing on the disk. 

COMPIL also reads this file each time a new CREF 

listing is generated to prevent multiple 

requests for the same file and to prevent 

discarding other requests that may not yet have 

been listed. 

Written by DAEMON to be read by DUMP. 

Read by DUMP as an input command file. 

Used by COMPIL to store the arguments of the 

most recent EDIT, CREATE, TECO, or MAKE command. 
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TEMPORARY FILES 



Table C-l (Cont. ) 
Temporary Files 



Name 



Meaning 



nnn EDT.TMP 



nnn ERA.TMP 
nnn FAl.TMP 
nnn FOR.TMP 

nnn GEN.TMP 

nnn KJO.TMP 
nnn LGO.TMP 
nnn LHC.TMP 

nnn LIN.TMP 
nnn LIT.TMP 
nnn LLC.TMP 

nnn LLS.TMP 

nnn LNK.TMP 
nnn LOA.TMP 
nnn MAC.TMP 

nnn Pll.TMP 



nnn PLS.TMP 
nnn PIP.TMP 

nnn QUE.TMP 
nnn RNO.TMP 



nnn S01.TMP 



Written by COMPIL and read by LINED or TECO. It 
contains a command for each EDIT, CREATE, TECO, 
or MAKE command. For the MAKE or CREATE 
commands, it contains the command 

S file.ext [p,p] $ 

For TECO or EDIT commands, it contains the 
command 



S file.ext [p,p] 



is the 



each 



Written, read, and deleted by COBOL and 

error file. 

Read by FAIL and contains one line for 

program to be compiled. 

Read by FORTRAN and contains one line for each 

program to be compiled. It may also contain the 

command NAME! which causes FORTRAN to transfer 

control to the named program. 

Written, read, and deleted by COBOL and contains 

the output of syntax processing. 

Read by KJOB as an input command file. 

Read by LOGOUT as an input command file. 

Created and read by LINK-10 and contains the 

overflow of the user's high segment. The file 

is used to produce core images or saved files. 

Created by LINED and contains output file until 

the rename process. 

Written, read, and deleted by COBOL and contains 

copy of the literal pool. 

Created and read by LINK-10 and contains the 

overflow of the user's low segment. This file 

is used to produce core images or saved files. 

Created and read by LINK-10 and contains the 

overflow of the user's symbol file. This file 

is used to produce core images or saved files. 

Read by LINK-10 and contains commands necessary 

for loading. 

Read by LOADER and contains 

for loading. 

Read by MACRO and contains 

program to be assembled. 

the command NAME" which 

transfer control to the named program. 

Read by MACYll (the PDP-11 assembler for the 

PDP-10) and contains one line for each program 

to be assembled. 

Read by PLEASE as an input command file. 

Read by PIP and contains commands to implement 

the COMPIL-class commands that run PIP. 

Read by QUEUE as an input command file. 

Read by RUNOFF and contains commands for each 

file which has produced a RUNOFF listing on the 

disk. 

Written, read and deleted by COBOL and contains 

the intermediate sorted results of the data. 



commands necessary 

one line for each 
It may also contain 
causes MACRO to 
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TEMPORARY FILES 



Table C-l (Cont. ) 
Temporary Files 



Name 


Meaning 


nnn SVC.TMP 

nnn SNO.TMP 

nnn TEC.TMP 

nnn TMP.TMP 
nnn XFO.TMP 

nnn XFR.TMP 


Used by COMPIL to store the arguments of the 

most recent COMPIL, LOAD, EXECUTE, or DEBUG 

command. 

Read by SNOBOL and contains one line for each 

program to be compiled. 

Created by TECO and contains output file until 

the rename process. 

Created by LINED during the rename process. 

Created by FILEX as a result of the Q switch on 

the output side. 

Created by FILEX as a result of the Q switch on 

the input side. 
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APPENDIX D 
SIXBIT/ASCII CHARACTER CODES 







ASCII 






ASCII 




ASCII 


SIXBIT 


Character 


7-Bit 


SIXBIT 


Character 


7-Bit 


Character 


7-Bit 


00 


Space 


040 


40 




100 


- 


140 


01 


i 


041 


41 


A 


101 


a 


141 


02 


ii 


042 


42 


B 


102 


b 


142 


03 


# 


043 


43 


C 


103 


c 


143 


04 


$ 


044 


44 


D 


104 


d 


144 


05 


% 


045 


45 


E 


105 


e 


145 


06 


& 


046 


46 


F 


106 


f 


146 


07 


■ 


047 


47 


G 


107 


g 


147 


10 


( 


050 


50 


H 


110 


h 


150 


11 


) 


051 


51 


I 


111 


i 


151 


12 


* 


052 


52 


J 


112 


j 


152 


13 


+ 


053 


53 


K 


113 


k 


153 


14 


i 


054 


54 


L 


114 


1 


154 


15 


- 


055 


55 


M 


115 


m 


155 


16 


. 


056 


56 


N 


116 


n 


156 


17 


/ 


057 


57 





117 


o 


157 


20 





060 


60 


P 


120 


P 


160 


21 


1 


061 


61 


Q 


121 


q 


161 


22 


2 


062 


62 


R 


122 


r 


162 


23 


3 


063 


63 


S 


123 


s 


163 


24 


4 


064 


64 


T 


124 


t 


164 


25 


5 


065 


65 


U 


125 


u 


165 


26 


6 


066 


66 


V 


126 


V 


166 


27 


7 


067 


67 


W 


127 


w 


167 


30 


8 


070 


70 


X 


130 


X 


170 


31 


9 


071 


71 


Y 


131 


Y 


171 


32 


j. 


072 


72 


Z 


132 


z 


172 


33 


/ 


073 


73 


[ 


133 


{ 


173 


34 


< 


074 


74 


\ 


134 


\ 


174 


35 


= 


075 


75 


] 


135 


} 


175 


36 


> 


076 


76 


t 


136 


>\j 


176 


37 


? 


077 


77 


-<- 


137 


Delete 


177 



D-l 



INDEX 



as wildcard asterisk, 
1-11 
+ construction, 1-17 
/6 switch, 2-62 
<> construction, 1-18 
= : construction, 1-17 
@ construction, 1-16 
Abbreviate, 

commands, 1-6 
Absolute, 

argument, 1-13 
Access, 

protection code, 1-10 

system, 1-7, 2-134 
/ACTIVE, 

MOUNT switch, 2-145 
ADDRESS command to DUMP, 

2-65 
ALCFIL program, 2-9 
.ALG, 2--17 
/ALGOL , 

LOAD switch, 2-128 
/ALGOL switch, 2-18, 2-76 
ALL command to DUMP, 2-65 
Allocate, 

device, 2-11 

space, 2-9 
/ALTMODE , 

LOGIN switch, 2-134 
Angle brackets, 1-10 
APPEND command to DUMP, 

2-65 
Arguments, 

command, 1-7 

date-time, 1-13 
Assign, 

device, 2-144 
ASSIGN command, 2-11 
Associate, 

logical names, 1-8, 2-11 
Asterisk (*) , 1-3 

as wildcard, 1-11 
ATTACH command, 2-13 
AUTOFORMAT command to DUMP, 
2-65 



.BIO, 2-17 
Backslashes, 1-4 
Backspace, 

magtape, 2-151 
BACKSPACE command, 2-15 
BACKUP program, 2-16 



Batch, 

command interpreter, 1-6 
/BATCH, 

KJOB switch, 2-120 
/BIN, 

Load switch, 2-128 
/BIN switch, 2-18, 2-76 
Binary compare switches, 

2-88 
/BLANK , 

LOGIN switch, 2-134 
.BLI, 2-17 
/BLISS, 

LOAD switch, 2-128 
/BLISS switch, 2-18, 2-76 
Blocks, 

read, 2-61 

written, 2-61 
BSLDR.REL, 2-62 



/C switch, 2-62 
Card deck, 

sample, 1-3 
Cards, 

punch, 2-26 
CATEGORY command to DUMP, 

2-66 
.CBL, 2-17 

CCONTINUE command, 2-31 
.CDP extension, 2-26 
CDP:, 1-8 
CDR:, 1-8 
Characters, 

delete, 1-4 
/CHECK, 

MOUNT switch, 2-146 
/CHECK switch, 2-57 
CLOSE command to DUMP, 2-66 
Cluster, 

size, 2-9 
.CMD extension, 1-16 
/COBOL, 

LOAD switch, 2-128 
/COBOL switch, 2-18, 2-76 
Command, 

arguments, 1-7 

ASSIGN, 2-11 

ATTACH, 2-13 

BACKSPACE, 2-15 

CCONTINUE, 2-31 

COMPILE, 2-17 

completion, 1-3 

CONTINUE, 2-23 



Index-1 



INDEX (CONT.) 



t.) 



Command (Con 
Copy, 2-24 
CORE, 2-25 
CPUNCH, 2-26 
CREATE, 2-28 
CREF, 2-30 
C START, 2- 
D (eposit) , 
DAYTIME, 2- 
DCORE, 2-3 
DDT, 2-38 
DEASSIGN, 
DEBUG, 2-4 
DELETE, 2- 
DETACH, 2- 
DIRECT, 2- 
DISMOUNT, 
DSK, 2-61 
DUMP, 2-64 
EDIT, 2-74 
EOF, 2-75 
EXAMINE, 2 
EXECUTE, 2- 
file, 1-16 
FILE, 2-98 
FINISH, 2- 
format, 1- 
FUDGE, 2-1 
GET, 2-107 
HALT, 2-11 
HELP, 2-11 
INITIA, 2- 
JCONTINUE, 
KJOB, 2-12 
LABEL, 2-1 
LIST, 2-12 
LOAD, 2-12 
LOCATE, 2- 
LOGIN, 2-1 
MAKE, 2-14 
2-1 



31 

2-33 
-34 
5 

2-39 



46 

47 

48 

2-56 



-73 
-76 



MAKE , 2 
MOUNT, ^-j. 
names, 1-6 
NODE, 2-15 
NSAVE, 2-1 
NSSAVE, 2- 
OSAVE, 2-1 
OSSAVE, 2- 
PJOB, 2-16 
PLEASE, 2- 
PLOT, 2-16 
PRESERVE, 
PRINT, 2-1 
PROTECT, 2 
QUEUE, 2-1 
R, 2-187 
REASSIGN, 
REATTA , 2- 
REENTER, 2 



105 

6 

06 

2 
3 
117 

2-119 


25 
6 
7 

133 
34 
3 
44 

2 

53 

154 

60 

162 

3 

164 

6 

2-168 

69 

-171 

73 

2-188 

189 

-190 



Command (Cont.) 

RENAME, 2-191 

RESOURCE, 2-192 

REWIND, 2-193 

RUN, 2-194 

SAVE, 2-19 6 

SCHED, 2-197 

SEND, 2-198 

SET BLOCKSIZE, 2-200 

SET BREAK, 2-201 

SET CDR, 2-204 

SET CPU, 2-205 

SET DEFAULT, 2-207 

SET DENSITY, 2-208 

SET DSKFUL, 2-209 

SET DSKPRI, 2-210, 2-211 

SET PHYSICAL, 2-212 

SET SPOOL, 2-213 

SET TIME, 2-218 

SET TTY, 2-220 

SET WATCH, 2-227 

SKIP, 2-228 

START, 2-231 

SUBMIT, 2-232 

SYSTAT, 2-234 

TECO, 2-238 

TIME, 2-239 

TPUNCH, 2-241 

TYPE, 2-243 

UNLOAD, 2-245 

USESTAT, 2-246 

VERSION, 2-247 

WHERE, 2-249 

ZERO, 2-250 
Command interpreter, 

batch, 1-6 
Commands, 2-113 

abbreviate, 1-6 

COMPIL-CLASS, 1-15 

continuation, 1-6 

deleting, 2-1 

indirect, 1-16 

terminate, 1-6 
Comments, 1-6 
Compare, 

DECtapes, 2-62 

files, 2-87 
COMPIL-CLASS commands, 1-15 
/COMPILE, 

LOAD switch, 2-128 
Compile, 

switches, 1-18 
COMPILE command, 2-17 
/COMPILE switch, 2-18, 2-77 
Complaints, 

operation, 2-111 
Completion, 

command, 1-3 
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INDEX (CONT.) 



Construction, 

+, 1-17 

<>, 1-18 

=, 1-17 

@, 1-16 
Continue, 

a job, 2-119 

commands, 1-6 
CONTINUE command, 2-23 
Control , 

character, 1-2 
Control command, 1-3 

processing, 1-6 
Control file, 1-3 
Copy, 

DECtapes, 2-62 

magtape, 2-151 
Core, 

deposit in, 2-33 

examine location, 2-73 
/CORE , 

LOGIN switch, 2-135 
Core, 

modify allocation, 2-25 
CORE command, 2-2 5 
Core image file, 

load, 2-107 
Correct, 

typing errors, 1-4 
CPUNCH command, 2-2 6 
Create, 

a file, 2-28, 2-143 

files, 2-3 
/CREATE , 

MOUNT switch, 2-14 6 
CREATE command, 2-28 
CREDIR program, 2-29 
/CREF , 

LOAD switch, 2-128 
CREF command, 2-30 
/CREF switch, 2-19, 2-77 
/CRLF , 

LOGIN switch, 2-135 
Cross-referenced file, 2-30 
CRTL/U, 1-4 
CSTART command, 2-31 
CTRL/C, 1-2, 1-4 
CTRL/O, 1-4 
CTRL/R, 1-5 
CTRL/T, 1-5 
CTY:, 1-8 



D(eposit) command, 2-33 

DAEMON, 2-35 

Date, 

arguments, 1-13 
DAYTIME command, 2-34 



DCORE command, 2-35 
DDT command, 2-38 
DEASSIGN command, 2-39 
/DEBREAK , 

LOGIN switch, 2-135 
DEBUG command, 2-40 
DECtape, 

compare, 2-62 

copy, 2-62 

delete files, 2-98 

format specifies, 2-102 

identifier, 2-125 
Delay, 

command, 1-3 
Delete, 

a line, 1-4 

commands, 2-1 

DECtape files, 2-98 

files, 2-46 
DELETE command, 2-4 6 
DELETE key, 1-4 
Density, 

magtape, 2-151 
DETACH command, 2-47 
Device, 

allocate, 2-11 

assign, 2-144 

attach to, 2-13 

directory, 1-10 

disassociate, 2-105 

names of, 1-8 

reassign, 2-56 

restricted, 2-2 

return, 2-39, 2-56 

unrestricted, 2-2 
DIRECT command, 2-48 
Directory, 

devices, 1-10 

names, 1-10 
DIS:, 1-8 
Disassociate, 

device, 2-105 

logical names, 1-8 
Disconnect, 

terminal, 2-47 
Disk, 

area, 1-10 

save files, 2-16 

usage, 2-61 
Disk files, 

save, 2-16, 2-82 
DISMOUNT command, 2-56 
Dollar sign ($) , 1-3, 1-7 
DPx:, 1-8 
DSK command, 2-61 
DSK:, 1-8 
/DSKFUL, 

LOGIN switch, 2-135 
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/DSKPRI, 

LOGIN switch, 2-136 

DTCOPY program, 2-62 

DTx:, 1-8 

DUMP, 

ADDRESS command to, 2-65 
ALL command to, 2-65 
APPEND command to, 2-65 
AUTOFORMAT command to, 

2-65 
CATEGORY command to, 2-66 
CLOSE command to, 2-66 
DUMP command to, 2-66 
EJECT command to, 2-66 
EXIT command to, 2-66 
INPUT command to, 2-66 
IRADIX command to, 2-67 
JUSTIFY command to, 2-67 
LEFTMA command to, 2-67 
LINEPA command to, 2-67 
MODES command to, 2-67 
NUMPAGE command to, 2-68 
OPTION command to, 2-68 
ORADIX command to, 2-69 
OUTPUT command to, 2-69 
RIGHTMAR command to, 2-69 
RUN command to, 2-69 
SUPERSEDE command to, 

2-69 
SYFILE command to, 2-69 
TDUMP command to, 2-70 
TITLE command to, 2-70 
TYPE command to, 2-70 
WIDTH command to, 2-70 
XTRACT command to, 2-70 

DUMP command, 2-64 

DUMP command to DUMP, 2-66 

DUMP program, 2-65 



/ECHO, 

LOGIN switch, 2-136 
EDIT command, 2-74 
Editor , 

LINED, 2-28 
EJECT command to DUMP, 2-66 
$EOF card, 1-1 
EOF command, 2-75 
Erroneous symbols, 

list, 2-108 
EXAMINE command, 2-73 
Example, 

card deck, 1-3 
EXECUTE command, 2-7 6 
EXIT command to DUMP, 2-66 
Extension, 

.CDP, 2-26 

file name, 1-10 



Extension (Cont. ) , 
processor, 1-19 
source file, 2-17 



/F10, 

LOAD switch, 2-129 
/F10 switch, 2-78 
/F1IO switch, 2-19 
.F4, 2-17 
/F40, 

LOAD switch, 2-129 
/F40 switch, 2-78 
/F40 switch, 2-20 
Facility allocation, 

commands, 2-1 
.FAI, 2-17 

FAILSA program, 2-82 
/FAST, 

KJOB switch, 2-120 
•FCL, 2-17 
/FDTA switch, 2-50 
Feature test switches, 2-1 
Features, 

system, 2-113 
FHx:, 1-8 

FILCOM program, 2-87 
File, 

backspace, 2-15 

command, 1-16 

compare, 2-87 

create a, 2-28, 2-143 

cross-referenced, 2-30 

delete, 2-46 

edit a, 2-74 

format specifiers, 2-102 

list, 2-126 

move, 2-82 

preparation commands, 2-3 

specifications, 1-10 

structure names, 1-10 

temporary, 1-15 

transfer, 2-24, 2-98, 2-102 
FILE command, 2-98 
Files, 1-10 
/FILES switch, 2-50 
FILEX program, 2-102 
/FILL, 

LOGIN switch, 2-136 
FINISH command, 2-105 
.FOR, 2-17 
/FORM, 

LOGIN switch, 2-137 
Format, 

command, 1-6 
Format specifiers, 2-102 
/FOROTS , 

LOAD switch, 2-128 
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/FOROTS switch, 2-77 
/FORSE, 

LOAD switch, 2-128 
/FORTRAN , 

LOAD switch, 2-128 
/FORTRAN switch, 2-19, 2-77 
/FUDGE, 

LOAD switch, 2-128 
FUDGE command, 2-106 
/FUDGE switch, 2-19, 2-77 
Functions, 

system, 1-1 



/G switch, 2-62 
/GAG, 

LOGIN switch, 2-137 
Generic, 

names, 1-8 
GET command, 2-107 
GLOB program, 2-108 
Global symbols list, 2-108 
GRIPE program, 2-111 
/GUIDELINE, 

LOGIN switch, 2-137 



/H switch, 2-62 
HALT command, 2-112 
/HELP, 

KJOB switch, 2-120 
MOUNT switch, 2-146 
HELP command, 2-113 
/HELP switch, 2-50, 2-57 
Hyphen, 1-6 



I/O, 

stop, 2-120 
Identifier , 

DECtape, 2-125 
Indirect, 

commands, 1-16 
/INDIRECT switch, 2-50 
INITIA command, 2-117 
Initialization, 

system, 2-117 
Input, 

terminate, 2-105 
INPUT command to DUMP, 2-66 
Input spooler mode, 1-3 
Internal symbol table, 

2-108 
Interpreter , 

batch command, 1-6 



Interrupt, 

program, 1-4 
IRADIX command to DUMP, 
2-67 



JCONTINUE command, 2-119 
Job, 

attach to, 2-13 

continue a, 2-119 

initialization, 1-1, 2-1 

maximum number, 1-2 

stop, 2-112, 2-120 

terminate, 2-7 
JOB CAPACITY EXCEEDED, 1-2 
$JOB card, 1-1 
Jobs, 

initiate, 1-1 
JUSTIFY command to DUMP, 
2-67 



/K?10 switch, 2-20 
/KA10, 

LOAD switch, 2-129 
/KA10 switch, 2-78 
/KEEP switch, 2-57 
Key, 

control, 1-2 

DELETE, 1-4 
/KI10 siwtch, 2-78 
KJOB command, 2-120 
KJOB switch, 

/BATCH, 2-120 

/FAST, 2-120 

/HELP, 2-120 

/NOMESSAGE, 2-120 



/L switch, 2-62 
LABEL command, 2-125 
Labels, 

DECtape, 2-125 
/LC, 

LOGIN switch, 2-137 
LEFTMA command to DUMP, 

2-67 
/LIB, 

LOGIN switch, 2-138 
/LIBRARY, 

LOAD switch, 2-129 
Library file, 2-106 
Library search mode, 2-108, 

2-109 
/LIBRARY switch, 2-78 
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/LIMIT, 

LOGIN switch, 2-138 
Line, 

delete a, 1-4 
LINED, 2-74 
LINED editor, 2-28 
LINEPA command to DUMP, 

2-67 
/LINK, 

LOAD switch, 2-129 
/LINK switch, 2-78 
Linking loader, 

switches, 1-24 
List, 

erroneous symbols, 2-108 

global symbols, 2-108 
/LIST, 

LOAD switch, 2-129 
List, 

nonrelocatable symbols, 
2-109 

relocatable symbols, 
2-109 
LIST command, 2-126 
/LIST switch, 2-20, 2-50, 

2-78 
/LMAP , 

LOAD switch, 2-130 
/LMAP switch, 2-78 
Load, 

core image file, 2-107 

.REL file, 2-76 

.REL files, 2-127 
LOAD command, 2-127 
LOAD switch, 

/ALGOL, 2-127 

/BIN, 2-127 
LOAD switches, 2-127 
/LOADER, 

LOAD switch, 2-130 
/LOADER switch, 2-78 
LOCATE command, 2-133 
Logical , 

device name, 1-8, 2-11 
LOGIN command, 2-134 
7LOGIN please, 1-4 
LPT, 

spooled, 2-126 
LPT:, 1-8 
.LSP, 2-17 



.MAC, 2-17 
/MACRO, 

LOAD switch, 2-130 
/MACRO switch, 2-20, 2-78 
/MACY11, 

LOAD switch, 2-130 



/MACY11 switch, 2-20, 2-79 
Magtape, 

backspace, 2-15, 2-151 

copy, 2-151 

density, 2-151 

rewind, 2-151 

save files on, 2-82 

verify, 2-151 
MAKE command, 2-143 
/MANTIS, 

LOAD switch, 2-130 
/MANTIS switch, 2-20, 2-79 
/MAP, 

LOAD switch, 2-130 
/MAP switch, 2-79 
/MARKS switch, 2-50 
Mask , 

password, 1-7 
Messages, 

operator, 2-111 

send, 2-7 
Mode, 

input spooler, 1-3 

library search, 2-108, 2-109 

monitor, 1-2 

user, 1-2 
MODES command to DUMP, 2-67 
Modify, 

core allocation, 2-25 
Monitor mode, 1-2 
MOUNT command, 2-144 
Move, 

disk files, 2-16 

files, 2-82 
MTCOPY program, 2-151 
MTx:, 1-8 
/MULTI, 

MOUNT switch, 2-146 
Multiply defined symbol, 2-110 
Multiply specified symbol, 
2-110 



/N switch, 2-62 
/NAME , 

LOGIN switch, 2-138 
Names, 

command, 1-6 

device, 1-8 

directory, 1-10 

file, 1-10 

file structure, 1-10 

generic, 1-8 

logical, 1-8, 2-11 

node, 1-8 
/NEW, 

LOAD switch, 2-130 

LOGIN switch, 2-138 
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/NEW switch, 2-20 , 2-1S 
nnnDAE.TMP file, 2-64 
?NO core assigned, 1-4 
/NOALTMODE , 

LOGIN switch, 2-134 
/NOBIN, 

LOAD switch, 2-130 
/NOBIN switch, 2-20 
/NOBLANK , 

LOGIN switch, 2-135 
/NOCOMPILE, 

LOAD switch, 2-130 
/NOCOMPILE switch, 2-21 
NODE command, 2-152 
Node name, 1-8 
Nodes, 2-133 

specifying, 2-1 
/NOECHO, 

LOGIN switch, 2-13 6 
/NOLI ST, 

LOAD switch, 2-130 
/NOLIST switch, 2-21 
/NOMANTIS, 

LOAD switch, 2-131 
/NOMANTIS switch, 2-21 
/NOME S SAGE, 

KJOB switch, 2-120 
Nonrelocatable symbols, 

list, 2-109 
/NORMAL switch, 2-51 
/NOSEARCH, 

LOAD switch, 2-131 
/NOTE , 

LOGIN switch, 2-138 
NSAVE command, 2-153 
NSSAVE command, 2-154 
Number sign (#) , 1-12 
Numbers, 

project-programmer, 1-7 
NUMPAGE command to DUMP, 
2-68 



/OLD , 

LOAD switch, 2-131 
/OLD switch, 2-21, 2-80 
OPR:, 1-8 

OPSER program, 2-155 
Option, 

files, 1-14 
OPTION command to DUMP, 

2-68 
Option files, 1-14 
/OPTION switch, 2-51 
ORADIX command to DUMP, 

2-69 
OSAVE command, 2-160 
OS SAVE command, 2-162 



Output, 

global symbols, 2-108 

suppress, 1-4 

terminate, 2-105 
OUTPUT command to DUMP, 

2-69 
Override, 

system defaults, 1-14 



.Pll, 2-17 
/PAGE , 

LOGIN switch, 2-139 
/PARITY switch, 2-51 
PARTIAL ALLOCATION ONLY, 

2-9 
/PASSIVE, 

MOUNT switch, 2-145 
Passwords, 1-7 
/PAUSE, 

MOUNT switch, 2-146 
/PAUSE switch, 2-57 
Percent sign (%) , 1-24 
Period (.) , 1-3 
Permanent, 

switches, 1-18 
/PHYSICAL, 

LOGIN switch, 2-139 
/PHYSICAL switch, 2-51 
PJOB command, 2-163 
PLEASE command, 2-164 
PLOT command, 2-166 
PLT:, 1-8 

/PRDEVICE switch, 2-51 
/PRDIR switch, 2-52 
PRESERVE command, 2-168 
Prime (') character, 2-110 
Print, 

status information, 1-5 
PRINT command, 2-169 
Processing specifiers, 

2-102 
Processor , 

extension, 1-19 

standard, 1-19 

switches, 1-20 
Program, 

ALCFIL, 2-9 

BACKUP, 2-16 

continue, 2-23 

CREDIR, 2-29 

DTCOPY, 2-62 

DUMP, 2-65 

execute, 2-76 

FAILSA, 2-82 

FILCOM, 2-87 

FILEX, 2-102 

GLOB, 2-108 
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Program (Cont.) , 

GRIPE, 2-111 

interrupt, 1-4 

MTCOPY, 2-151 

OPSER, 2-155 

QUOLST, 2-186 

SETSRC, 2-214 

stop, 1-2, 2-112 
Project-programmer numbers, 

1-7 
PROTECT command, 2-171 
/PROTECT switch, 2-52 
Protection code, 

access, 1-10 

standard, 1-11 
PTP:, 1-8 
PTR: , 1-8 
PTY:, 1-8 
Public, 

file structures, 1-10 
Punch, 

cards, 2-26 



Question mark, 

as wildcard, 1-12 
QUEUE command, 2-173 
QUEUE switches, 2-175 
QUIKDM.CCL, 2-64 
QUOLST program, 2-186 
/QUOTA, 

LOGIN switch, 2-139 



/REL switch, 2-80 
Relative, 

argument, 1-13 
/RELEASE switch, 2-57 
Relocatable symbols, 

list, 2-109 
/REMOVE switch, 2-57 
RENAME command, 2-191 
RESOURCE command, 2-192 
Restore, 

files, 2-82 
Restricted, 

devices, 2-2 
Restricted devices, 

assign, 2-11 
Return, 

devices, 2-39, 2-56 
Rewind, 

magtape, 2-151 
REWIND command, 2-193 
/REWIND switch, 2-52, 2-57 
RIGHTMAR command to DUMP, 

2-69 
/RONLY, 

MOUNT switch, 2-146 
/RUN, 

LOGIN switch, 2-139 
RUN command, 2-194 
RUN command to DUMP, 2-69 
/RUN switch, 2-52 
/RUNOFFSET switch, 2-52 



R command, 2-187 
/RCVSPEED, 

LOGIN switch, 2-139 
Read , 

blocks, 2-61 

DECtape directory, 2-98 
Reassign, 

device, 2-56 
REASSIGN command, 2-188 
/REASSIGN swtich, 2-57 
REATTA command, 2-189 
Records, 

backspace, 2-15 
/REELID, 

MOUNT switch, 2-146 
REENTER command, 2-190 
/REL, 

LOAD switch, 2-131 
.REL file, 

load, 2-76 

produce, 2-17 
.REL files, 

load, 2-127 



.SAI, 2-17 
Sample, 

card deck, 1-3 
Save, 

disk files, 2-82 
SAVE command, 2-19 6 
/SCAN, 

LOGIN switch, '2-139 
SCHED command, 2-197 
/SEARCH, 

LOAD switch, 2-131 
/SEARCH switch, 2-80 
/SELF, 

LOAD switch, 2-131 
/SELF switch, 2-21, 2-80 
Semicolon, 1-6 
Send, 

messages, 2-7 
SEND command, 2-198 
SET BLOCKSIZE command, 

2-200 
SET BREAK command, 2-201 
SET CDR command, 2-204 
SET CPU command, 2-205 
SET DEFAULT command, 2-207 
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SET DENSITY command, 2-208 
SET DSKFUL command, 2-209 
SET DSKPRI command, 2-210, 

2-211 
SET PHYSICAL command, 2-212 
SET SPOOL command, 2-213 
SET TIME command, 2-218 
SET TTY command, 2-220 
SET WATCH command, 2-227 
SETSRC program, 2-214 
/SETTTY , 

LOGIN switch, 2-140 
SFD, 1-10 
/SHOVE , 

MOUNT switch, 2-146 
/SINCE switch, 2-52 
/SINGLE, 

MOUNT switch, 2-146 
Siwtch, 

/KI10, 2-78 
Size, 

cluster, 2-9 
SKIP command, 2-228 
/SLOW switch, 2-52 
/SNOBOL, 

LOAD switch, 2-131 
/SNOBOL switch, 2-21, 2-80 
/SORT switch, 2-52 
Source compare switches, 

2-88 
Source file, 

translate, 2-76, 2-127 
Source files, 

list, 2-126 
Space, 

allocate, 2-9 
Specifying, 

nodes, 2-1 
/SPEED, 

LOGIN switch, 2-140 
/SPOOL, 

LOGIN switch, 2-140 
Spooled LPT, 2-126 
SPRINT-10, 1-3 
Standard, 

processor, 1-19 

protection code, 1-11 

translator, 2-17 
START command, 2-231 
Station numbers, 1-8 
Status information, 

print, 1-5 
/STAY switch, 2-57 
Stop, 

I/O, 2-120 

job, 2-120 

job/program, 2-112 

program, 1-2 



/STR, 

LOGIN switch, 2-140 
Sub-file directory, 1-10 
SUBMIT command, 2-232 
Substituting , 

devices, 1-8, 2-11 
/SUMMARY switch, 2-52 
SUPERSEDE command to DUMP, 

2-69 
Suppress, 

output, 1-4 
Switch, 

/6, 2-62 

/ALGOL, 2-18, 2-76 

/BIN, 2-18, 2-76 

/BLISS, 2-18, 2-76 

/C, 2-62 

/CHECK, 2-57 

/COBOL, 2-18, 2-76 

/COMPILE, 2-18, 2-77 

/CREF, 2-19, 2-77 

/F10, 2-78 

/F1IO, 2-19 

/F40, 2-78 

/F40, 2-20 

/FDTA, 2-50 

/FILES, 2-50 

/FOROTS, 2-77 

/FORTRAN, 2-19, 2-77 

/FUDGE, 2-19, 2-77 

/G, 2-62 

/H, 2-62 

/HELP, 2-50, 2-57 

/INDIRECT, 2-50 

/K?lO, 2-20 

/KA10, 2-78 

/KEEP, 2-57 

/L, 2-62 

/LIBRARY, 2-78 

/LINK, 2-78 

/LIST, 2-20, 2-50, 2-78 

/LMAP, 2-78 

/LOADER, 2-78 

/MACRO, 2-20, 2-7 8 

/MACY11, 2-20, 2-79 

/MANTIS, 2-20, 2-79 

/MAP, 2-79 

/MARKS, 2-50 

/N, 2-62 

/NEW, 2-20, 2-79 

/NOBIN, 2-20 

/NOCOMPILE, 2-21 

/NOLIST, 2-21 

/NOMANTIS, 2-21 

/NORMAL, 2-51 

/OLD, 2-21, 2-80 

/OPTION, 2-51 

/PARITY, 2-51 
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Switch (Cont.) 

/PAUSE, 2-57 

/PHYSICAL, 2-51 

/PRDEVICE, 2-51 

/PRDIR, 2-52 

/PROTECT, 2-52 

/REL, 2-80 

/RELEASE, 2-57 

/REMOVE, 2-57 

/REWIND, 2-52, 2-57 

/RUN, 2-52 

/RUNOFFSET, 2-52 

/SEARCH, 2-80 

/SELF, 2-21, 2-80 

/SINCE, 2-52 

/SLOW, 2-52 

/SNOBOL, 2-21, 2-80 

/SORT, 2-52 

/STAY, 2-57 

/SUMMARY, 2-52 

/SYS, 2-80 

/T, 2-62 

/TITLES, 2-52 

/UNITS, 2-52 

/UNLOAD, 2-58 

/V, 2-62 

/VID, 2-58 

/WAIT, 2-58 

/WIDTH, 2-52 

/WORDS, 2-53 

/WRITTEN, 2-53 

/Z, 2-62 
SWITCH.INI, 1-14 
Switches, 

binary compare, 2-87 

compile, 1-18 

FAILSA, 2-82 

for LOAD command, 2-127 

linking loader, 1-24 

permanent, 1-18 

processor, 1-20 

QUEUE, 2-175 

source compare, 2-87 

temporary, 1-18 
Swtich, 

/REASSIGN, 2-57 
SYFILE command to DUMP, 

2-69 
Symbol , 

multiply defined, 2-110 

multiply specified, 2-110 

undefined, 2-110 
Symbol table, 

internal, 2-108 
Symbols list, 

global, 2-108 
/SYS 

LOAD switch, 2-131 

LOGIN switch, 2-140 



/SYS switch, 2-80 

SYS:, 1-8 

SYSTAT command, 2-234 

System, 

access, 2-134 

access to, 1-7 

functions, 1-1 

initialization, 2-117 
System defaults, 

override, 1-14 



/T switch, 2-62 
/TABS, 

LOGIN switch, 2-141 
/TAPE , 

LOGIN switch, 2-141 
TDUMP command to DUMP, 2-70 
TECO command, 2-238 
Temporary, 

files, 1-15 

switches, 1-18 
Terminal , 

disconnect, 2-47 
Terminate, 

commands, 1-6 

input/output, 2-105 

job, 2-7 
Time, 

arguments, 1-13 
/TIME, 

LOGIN switch, 2-141 
TIME command, 2-239 
TITLE command to DUMP, 2-70 
/TITLES switch, 2-52 
.TMP extension, 1-16 
?TOO FEW ARGUMENTS, 1-7 
TPUNCH command, 2-241 
Transfer , 

files, 2-24, 2-82, 2-98, 
2-102 
Translate, 

source file, 2-76, 2-127 
Translator , 

standard, 2-17 
Translators, 2-17 
Transport, 

disk files, 2-16 
TTY command, 

SET, 2-220 
TTY. INI, 2-117 
TTY:, 1-8 

TYPE command, 2-243 
TYPE command to DUMP, 2-70 
Type-ahead technique, 1-3 
Typing errors, 

correct, 1-4 
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UFD, 1-10 

Undefined symbol, 2-110 

/UNITS switch, 2-52 

UNLOAD command, 2-245 

/UNLOAD switch, 2-58 

Unrestricted, 

devices, 2-2 
Unrestricted devices, 

assign, 2-11 
Useage, 

disk, 2-61 
User file directory, 1-10 
User mode, 1-2 
USESTAT command, 2-246 



/V switch, 2-62 
Verify, 

magtape, 2-151 
VERSION command, 2-247 
/VID, 

MOUNT switch, 2-147 
/VID switch, 2-58 
/VIRTUAL, 

LOGIN switch, 2-141 



/WATCH, 

LOGIN switch, 2-141 
/WENABL , 

MOUNT switch, 2-147 
WHERE command, 2-249 
/WIDTH, 

LOGIN switch, 2-142 
WIDTH command to DUMP, 2-70 
/WIDTH switch, 2-52 
Wildcards, 1-11 
/WLOCK, 

MOUNT switch, 2-148 
/WORDS switch, 2-53 
/WRITE, 

MOUNT switch, 2-148 
Written, 

blocks, 2-61 
/WRITTEN switch, 2-53 



/XMTSPEED, 

LOGIN switch, 2-142 
XTRACT command to DUMP, 
2-70 



/WAIT, 

MOUNT switch, 2-147 
/WAIT switch, 2-58 



/Z switch, 2-62 
Zero, 

DECtape directory, 2-98 
ZERO command, 2-250 
"c, 1-2 
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